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BAKER BOTTS L.L.P. 
30 ROCKEFELLER PLAZA 
NEW YORK, NEW YORK 101 12 



TO ALL WHOM IT MAY CONCERN: 



Be it known that we, Ashutosh Dutta, having a post office address of 560 
Riverside Drive, Apt. # 17C, New York, New York 10027, Henning Schulzrinne, having a post 
^ office address of 3 1 3 Westview Avenue, Leonia, New Jersey 07605, and Yechiam Yemini, 
having a post office address of 223 Promenade, Edgewater, New Jersey 07020, have invented 

In 

^ SYSTEM AND METHOD FOR RECEIVING OVER A 

^ NETWORK A BROADCAST FROM A BROADCAST SOURCE 

Q FIELD OF THE INVENTION : 

yl 

H The present invention relates to a system and method for providing a broadcast 



5 over a network to a client. In particular, the system and method utilize netw^ork multicast 

communication for providing the broadcast of content between a broadcast source and the client 
to avail a global content and/or a local content to user. 

APPENDIX 

Attached hereto, please find an Appendix which shows an exemplary embodiment 
of the implementation of the system and method according to the present invention. 
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BACKGROUND INFORMATION : 

Conventional radio systems broadcast a continuous content without requiring 
extensive user interaction. This traditional scheme is convenient in situations where the listener 
is sharing his or her attention with other tasks, such as driving an automobile. However, one of 
the disadvantages of these conventional radio systems is that only a limited number of the radio 
stations can legally transmit their broadcasts in a particular area (e.g., only 45 FM radio stations 
can transmit their broadcast in the New York City metropolitan area). There: have been a number 
of proposed solutions to address this limitation. However, none of the proposed solutions 
effectively utilized the Internet to expand the number of radio broadcasts, as well as television 
broadcasts, to the wireless users who travel from one geographical area to another. 

A streaming real-time multimedia content (which relates to entertainment, music 
and /or interactive game industries) can now be provided over the Internet. The streaming 
applications include IP telephony, broadcasting multimedia content and multi-party conferences, 
collaborations and multi-player games. However, at least one publication (i.e., the New York 
Times) asserted that such multimedia streaming applications will bring about the demise of the 
Internet because the streaming applications are far more demanding in terms of bandwidth, 
latency and reliability than the traditional data communication applications. Many of the 
existing streaming systems do not scale to large audiences, particularly for a transmission at high 
bit rates. They also do not provide a user flexibility, and are restricted to a utilization of either 
conferencing or broadcast modes. 
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Early attempts to provide the streaming applications to the clients over the 
Internet have been implement using a unicast scheme. An exemplary system illustrating the 
system v^hich utilizes the conventional unicast architecture is shown in Figure 1. Referring to 
Figure 1, the source 100 (e.g., the audio and/or video content provider) is connected to a first 
router Rl, which in tum is connected to second and third routers R2, R3. The second router R2 
is connected to fourth and fifth routers R4, R5, while the third router R3 is connected to sixth and 
seventh routers R6, R7. The fourth router R4 is connected to two clients CO, CI, the fifth router 
R5 is connected to three clients C2, C3, C4, the sixth client R6 is connected to two clients C5, 
C6, and the seventh client R7 is connected to another three clients C7, C8, C9. The clients CO- 
CP may be computers requesting the particular multimedia content (e.g., an audio and/or video 
content). 

In operation, if each of the clients C0-C9 requests the same multimedia content, 
each of those requests is routed via their respective routers to the source 100. Particularly, the 
clients CO, CI send such request to the fourth router R4 which routes the request two streams for 
the particular multimedia content, i.e., one stream for each of its requesting clients CO, CI . At the 
same time, the fifth, sixth and seventh routers R5, R6, R7 may receive the requests for the same 
multimedia content from its respective clients C2-C9, and these routers R5, R6, R7 route their 
streams, respectively, for such multimedia content upstream. The requests for two and three 
identical multimedia streams (i.e., a total of five streams) are sent to the second router R2 from 
the fourth and fifth routers R4, R5, respectively. The requests for the same three and two 
multimedia streams (i.e., also a total of five streams) are sent to the third router R3 from the sixth 
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and seventh routers R6, R7, respectively. The second and third routers R2, R3 each route the 
request for five multimedia streams to the first router Rl, which routes a request for 10 
multimedia streams (i.e., 5 for the second router R2 and 5 for the third router R3) to the source 
100. 

Thus, the source 100 receives a request for 10 multimedia streams, and then 
transmits 10 multimedia streams to the first router Rl, which then routes the requested 5 
identical muhimedia streams to the second router R2, and the same 5 multimedia streams to the 
third router R3. The second router R2 then routes two of these multimedia streams to the fourth 
router R4, and three to the fifth router R5. The fourth router R4 routes 1 stream to the client CO 
and the other stream to the client CI . The fifth router R5 routes one of its received streams to the 
respective client, C2, C3, C4. Similar routing of the multimedia streams occurs for the third 
router R3 (and thus for the sixth and seventh routers, (R6, R7). 

By utilizing the unicast scheme described above and shown in Figure 1, there may 
be multiple copies of the same multimedia content being transmitted from the source down to the 
cHents. Such transmission of multiple streams may cause a bottleneck in the network by wasting 
the Internet bandwidth, and would likely prevent the clients from receiving the multimedia 
content in an expeditious manner. 

Figure 2 shows an arrangement utilizing a conventional muhicast communications 
scheme which addressed at least some of the above-mentioned drawbacks. For the sake of 
simplicity, the multicast arrangement in Figure 2 is substantially similar to that shown in Figure 
1 . Using the multicasting communications scheme illustrated in Figure 2, if each of the clients 
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C0-C9 requests the same multimedia content, the routers keep track of the particular client which 
made the request, and only sends one request for the multimedia stream upstream to the next 
router in the chain (or to the source 100). For example, the clients CO, CI may send such request 
(e.g., a join request) to the fourth router R4, which stores an indication (e.g., a state) therein that 
at least one of clients CO, CI sent the particular request. At the same time, the fifth, sixth and 
seventh routers R5, R6, R7 may receive the requests for the same multimedia content from its 
respective clients C2-C9, and each these routers R5, R6, R7 stores an indication therein 
regarding that at least one of their respective clients sent the request for multimedia stream. If 
the fourth router R4 (or the fifth router R5) already routed the multimedia streams to one of its 
clients (on the same subnet as the requesting client), it routes the multimedia streams to such 
requesting client. Otherwise each of the fourth and fifth routers R4, R5 sends a request to receive 
the multimedia stream that was requested by their respective clients C0-C4 to the second router 
R2. The second router R2 stores an indication that at least one of the fourth and fifth routers R4, 
R5 made the request. Each of the sixth and seventh routers R6, R7 also may send a request for 
the multimedia stream (i.e., that was requested by their respective clients C5-C9) to the third 
router R3. The third router R3 stores an indication which is similar to the one stored in the 
second router R2. Then, the second and third routers R2, R3 each send the request for the same 
multimedia stream to the first router Rl, which stores an indication regarding which of the 
routers R2, R3 made the request. Since the first router Rl is directly connected (or connected in 
the same subnet) to the source 100, the first router Rl always receives the multimedia stream 
from the source 100. 
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In this manner, the first router Rl receives the request, dupHcates the received 
muhimedia stream (via muUicast channels 500) and transmits 1 copy thereof to each of the 
second and third routers R2, R3 (if both made the request). The second router R2 then duplicates 
the received multimedia stream provided in the multicast channels 500, and sends one copy of 
the stream to each of the fourth and fifth router R4, R5. The fourth router R4, in turn, provides 
one copy of the received multimedia stream provided in the muhicast channels 500 to the client 
CO and the other copy to the client CI (if both made the request). The fifth router R5 duplicates 
the received multimedia stream, and sends one copy of the received multimedia stream provided 
by the multicast channels 500 to each of the respective client C2, C3, C4 (if each of theses clients 
made the request). A similar transmission of the multimedia streams occurs for the third router 
R3 (and thus for the sixth and seventh routers R6, R7). 

With this multicast scheme, the source 100 needs to only transmit one multimedia 
stream to the requesting router, which in turn duplicates the multimedia stream (if necessary) and 
transmits a single stream downstream to the routers and/or the clients requesting such stream. 
Indeed, each router (as well as the source 100) does not need to transmit more than one 
multimedia stream to the downstream routers. As such, the bandwidth of the system is utilized 
more efficiently. 

In addition, by using the multicast scheme described above, it is also possible to 
avoid a transmission of a request for the multimedia stream (that has already been provided to 
other clients by a particular router) upstream, all the way up to the server 100. For example, 
another client CIO may be connected to the fourth router R5, and this new client CIO may 
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request the multimedia stream from the fourth router R4 that has already been requested (and is 
provided to) the client CI . When the fourth router R4 receives this request from the new client 
CIO, it checks whether the requested multimedia stream has already been provided to it. If not, 
this request is then passed to the second router R2. If the fourth router R4 determines that the 
requested multimedia stream is already provided by it to at least one of its clients (is in the 
present exemplary case to the client CI), the fourth router sends a copy of the requested 
multimedia stream to the new client CIO without sending additional requests for this multimedia 
stream to the second router R2, and ultimately to the server. Even though this multicast 
communications scheme provides an advantageous transmission of the multimedia streams from 
the servers to the clients, it was not effectively usable for wireless communication or in systems 
where the broadcast streams from different sources which can immediately be provided to the 
wired or wireless clients. 

Previous attempts to provide next-generation radio and television systems have 
not been successful largely because these systems did not add significant benefits over the older 
and well known systems. Current versions of the Internet (or web) radio or television were not 
designed to utilize a large-scale multicast scheme, while also lacking the ability to support low- 
latency constraints and flexible programming (e.g., an automatic ad insertion during a program, 
an on-line monitoring of a particular channel, etc.). Furthermore, the conventional systems do not 
support a continuous streaming or conferencing, while the wireless client is moving, especially 
from one subnet to another. 
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SUMMARY OF THE INVENTION 

A system and method according to the present invention is provided for 
transmitting and receiving broadcasts between a broadcast source and a client. One of the 
exemplary embodiments of the system and method utilizes the available Intemet standards and 
protocols (e.g., RTP, RTCP, RTSP, SIP, SAP, SDP, UDP and IP multicast) to maximize their 
deployability. Other embodiments of the present invention utilize non-conventional technologies 
and/or protocols, such as a mobility-aware multicast scheme, a streaming protocol for wireless 
clients, a fast re-configuration, a bandwidth control for a multicast stream in a wireless network, 
etc. With the present invention, users can choose to tune-in to receive a local broadcast 
transmitted by a local station, a global broadcast transmitted by a global station. 

The system and method according to the present invention can send broadcasts in 
a single area, as well as to multiple regions, where there are listeners/viewers who would like to 
receive the broadcast. This system and method also provides the ability for the end user to invite 
another user to a particular program using SIP (Session Initiation Protocol). Thus, with the 
present invention it is now possible to provide: 

• Scalable mechanism for a selective content distribution with an automatic localized 
information insertion by using a hierarchical scope-based multicasting (e.g., global/local 
multicasting scheme) and local servers. 

• Application-layer multicasting arrangement for the real-time broadcast traffic. 

• Scalable hierarchical directory structure for an itemized content distribution. 

• Support for global and local programs with possible ways of mixing the two. 
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Popularity-based spectrum management to address the limits if the spectrum (e.g., a 

control mechanism for managing an audio/video stream based on a popularity of a 

particular program - capable of increasing the bandwidth of the broadcast which provides 

content for broadcasts which are popular with the users). 

Secure payment scheme between the content providers, advertisers and affiliates, which 
may be utilized for E-commerce. 

Support of a fast-handoff of the Internet Protocol multicast streams when the mobile 
clients move from one domain to another (e.g., moving in a car on a highway from one 
subnet to another) in a wireless environment. An application layer mobility protocol and 
a faster reconfiguration methodology can be provided for the wireless clients to 
implement such support. 

Distribution of a streaming content to the IP enabled wireless handset (e.g., IP enabled 

radio/television) using systems with wireless interface and a tuner. 

A combination of intra-ISP multicast with non-multicast global domain (e.g., the unicast 

domain). 

• Support of IP multicast scheme for streaming (e.g., using the MP3 standard) over the 
bandwidth constrained wireless medium. 

Secure multicast environment to protect against malicious data senders. 

One of the embodiments of the system of the present invention provides an 
architecture to facilitate an IP-based radio/television network, e.g., a streaming network. It can 
utilize the conventional Internet protocol suite to provide robust communication over 
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conventional heterogeneous access networks. For example, the system and method can also 
utilize any wired and/or wireless layer-2 technology such as, e.g., PPP ("point to point 
protocol"), CDMA ("code division multiple access"), protocol based on IEEE 802.1 1 standard, 
DSL ("digital subscriber link") and Gigabit Ethernet. It is also possible to utilize the system and 
method of the present invention other network technologies. The local servers used in the system 
and method according to the present invention, as well as the use of application layer, provide an 
degree of scalability. The flexibility of radio services a better reach and a quality of service for 
the audio/video stream carried over IP are just a few of the other advantageous features of the 
system and method according to the present invention. Both wired and wireless links may be 
used for interconnection to the system and method of the present invention, as well as to include 
various throughput, delay, and error rates. The present invention provides flexible 
radio/television streaming services to the local Internet (e.g., multimedia clients which may not 
necessarily be supported by the traditional AM/FM or television receivers). The system and 
method of the present invention also provides the flexibility to the clients to be able to receive 
broadcast from any radio or television station in the world. It offers the capability of a 
hierarchical searching in terms of categories, and a way to insert local advertisements during 
commercial breaks. This will meet the challenge of bringing quality audio/video broadcast to the 
people in remote site, and to the wireless mobile clients. Radio Antenna Servers are provided in 
the local domains act as local stations/localized servers so as to determine how many people can 
listen to a particular radio/television station globally without a possible degradation of stream 
quality and provides the ability for the local listeners in a single domain to switch between the 
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local program and the global program. These servers also provide the ability for the local 
listeners to receive the local advertisements during commercial breaks, while still being tuned to 
the global program or to continue listening to a particular segment of the global program while 
still being tuned to the local program. Another advantageous feature of the present invention is 
that the system and method allow any server connected to a communications network to be a 
potential broadcaster. The system and method also provides a pricing model which allows the 
servers (and possibly the broadcasters) to obtain a direct financial benefit therefrom. 

As indicated above, the system according to the present invention is preferably 
transport independent, operates over wired and wireless links, and accommodates the mobility of 
the client. Therefore, the present invention provides a continuity to the listener of a particular 
program broadcast by the local or global station as the mobile client moves. The system and 
method according to the present invention can also utilize a network topology of highly 
malleable meshes which would include more than just static trees where each client (or node) can 
be mobile. 

In an exemplary embodiment of the present invention, a broadcast is provided to a 
receiver via a communication network. The broadcast is received via at least one global multicast 
channel. At least one local multicast channel is associated with the global multicast address. A 
communication link is then established between the receiver and the local multicast channel, and 
the broadcast is routed from the global multicast channel to the local multicast channel to provide 
the broadcast to the receiver. The number of the receivers which are receiving the broadcast may 
also be determined. The receiver may include an Internet Protocol (IP) interface which enables 
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the receiver to receive the broadcast via an IP-type multicast communication. The receiver may 
also be wireless, and can receive the broadcast in a first subnet using a multicast communication. 
Prior to the receiver moving to a second subnet, a request is generated by the receiver to receive 
the broadcast in the second subnet. After receiving the request, the broadcast is provided to the 
wireless receiver in the second subnet using the multicast communication. 

The present invention will will now be described by way of detailed description of 
exemplary embodiments thereby with reference to the drawings, in which: 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a high level functional diagram showing a network based broadcasting 
system which utilizes a conventional unicast communication scheme; 

Figure 2 is a high level function diagram showing a network based broadcasting 
system of Figure 1 utilizing a conventional multicast communication scheme; 

Figure 3 is a functional block diagram showing an exemplary embodiment of a 
system according to the present invention which utilizes the multicast communication scheme for 
transmitting and receiving broadcast streams between a source and a client. 

Figure 4 is a functional system diagram showing an exemplary implementation of 
the system illustrated in Figure 3; 

Figure 5 is a diagram providing a detailed illustration of the functional 
architecture of another exemplary implementation of the system of Figure 3; 
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Figure 6A is a functional block diagram showing an exemplary embodiment of 
the Internet-capable broadcast receiving devices according to the present invention; 

Figure 6B is a functional block diagram showing an exemplary protocol stack, 
that can be used by the system and method of the present invention; 

Figure 7 is a flow diagram representing an exemplary embodiment of the method 
according to the present invention; 

Figure 8 is a flow diagram representing another exemplary embodiment of the 
method according to the present invention; 

Figure 9 is a schematic system-level functional diagram showing a detailed 
implementation of the system and method according to the present invention utilizing particular 
protocols; 

Figure 10 is a schematic system-level functional diagram showing an exemplary 
scheme in which multicast systems are interconnected via a non-multicast network; 

Figure 1 1 A is a functional diagram illustrating one embodiment of the system and 
method of the present invention for mobile clients; and 

Figure 1 IB is a functional diagram illustrating another embodiment of the system 
and method of the present invention for the mobile clients. 
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DETAILED DESCRIPTION 

A. SYSTEM ARCHITECTURE 

An exemplary embodiment of the system according to the present invention is 
shown in Figure 3. The illustrated exemplary embodiment includes four functional components, 
i.e., a Radio Station Client (RSC) 10 or a Primary Station, a Radio Antenna Server (RAS) 30 or a 
local station, an Advertisement/Media Arrangement (AMA) 40 and at least one Internet 
Multimedia Client (IMC) 50. It should be understood that RSC 10 can be a television station 
client, and RAS 30 can be a television antenna server. IMC 50 can be a car radio or another 
reception unit which is capable of receiving a multicast broadcast. Such car radio may be an 
Internet-capable Radio as shall be described in further detail below. In operation, RSC 10 (e.g., a 
computing device with IP interface) transmits a global multimedia broadcast via a 
communications network 20 (e.g., the Internet). RAS 30 (e.g., also a server) can receive the 
global broadcast from the communications network 20, and make this broadcast available to IMC 
50 using the multicast communication scheme described above with reference to Figure 2 and as 
shall be described in further detail below. In addition, RAS 30 can broadcast a local broadcast to 
IMC 50, preferably also using the multicast communications scheme as shall be described 
below. AMA 40 is coupled to RAS 30 so as to insert additional content, indicating 
advertisements, into the particular segments of the global broadcast that is received from RSC 10 
via the communications network 20. AMA 40 can be a separate server with its own storage 
database or a media database which is within RAS 30. IMC 50 can be used to receive the global 
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broadcast (which may include additional content inserted by AMA 40) as well as a local 
broadcast by RAS 30. 

An exemplary implementation of the system according to the present invention is 
shown in Figure 4. In this implementation, RSC 10 may include a content server 105. The 
server 105 (via an Internet Protocol communication arrangement 120) transmits the global 
broadcast (e.g., the multimedia content) to an arrangement of routers 140 which are part of the 
Internet (i.e., the communications arrangement 20). These routers 140 deliver the global 
broadcast to a local station 150 (e.g., part of RAS 30), which can pass this global broadcast to 
IMC 50. The multimedia content may also be distributed via one or more broadband low earth 
orbiting satellites 1 10 to RAS 30, via an earth station arrangement 130. As indicated above, the 
local station 150 can also provide its own local broadcast to IMC 50. The exemplary 
implementation shown in Figure 4 preferably utilizes the multicast communication throughout 
the system. However, if particular portions of the system are not capable of using such multicast 
communication, it is possible to utilize an alternate scheme in those particular portions as 
described in greater detail below. It is preferable to implement the multicast communication 
scheme described above with reference to Figures 2 and 4 between RSC 10 and RAS 30 as well 
as between RAS 30 and each IMC 50. 

Figure 5 shows a detailed illustration of another implementation of the system of 
Figure 3. This illustration and the illustration provided in Figure 2 shall be referred to below to 
explain a particular utilization of the multicast communication scheme and how such scheme 
may be modified in accordance with the system and method of the present invention. In 
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particular, all RSCs 10 have access to a plurality of multicast channels 500 (i.e., addressed at 
locations Ml to Mi). These addresses 10 may be provided in memory or on the hard drive of one 
of RSCs 10, in a shared memory distributed between, or may be located on a storage device 
remote from RSCs 10. The multicast address can also be assigned by a multicast address 
dispersing computer. In addition, all RSCs 10 have access to a global index address Mx. 

In general, a particular one of RSCs 10 may provide a multimedia stream at a 
particular multicast channel address (e.g.. Ml), and then announce to the global index address 
Mx that it has provided the multimedia stream on that particular address. As shall be explained 
in further detail below, the global multicast addresses are associated with local multicast 
addresses so that each RAS 40 can forward either the global broadcast provided in at least one of 
the multicast channels 500 (see Figure 2) broadcast by one or more of RSCs 10, as well as 
transmit the local broadcast that it generates. 

At boot-up time, the clients C0-C9 (i.e, IMCs 50) receive the information 
associated with the content provided in one or more of the multicast channels 500 (preferably by 
checking a local index address Imx which is associated with the global index address Mx as shall 
be described in further detail below). In particular, by checking an address which is associated 
with the global index address Mx, the clients C0-C9 may determine which multimedia stream is 
currently being provided in the local channels that are associated, at least in part, with the 
multicast channels Ml -Mi. Then, one or more of RASs 30 may generate the respective requests 
to receive one or more of the global multimedia streams (provided in the channels which may be 
associated with the multicast channels Ml -Mi). It is also possible for the clients (i.e., IMCs 50) 
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to receive the addresses of the updated multicast channels 500 from the source (i.e., RSC 10) in 
real-time or when desired. The requests are transmitted upstream to the routers (not shown) 
which are connected to the respective clients (i.e., IMCs 50). . 

Provided below is a detailed description of the exemplary components of the 
illustrative system and method according to the present invention described above, with 
reference to Figure 5. 

1. Radio/Television Station Client (RSC)/Primary Station 

As indicated above, RSC 10 can be a computing device of any regular 
radio/television station^roadcaste^ that is capable of transmitting its regular programming on an 
Internet Protocol-based network. It should be understood that Radio Station Client (RSC) can 
also be a station client which transmits a television type broadcast over the communications 
network. When RSC 10 broadcasts its program over the communications network 20 (e.g., the 
Internet), such broadcast is transmitted to an Internet gateway (not shovm in Figure 5) (e.g., a 
router) located near the server's location. Each primary station of RSC 10 (e.g., PSl, PS2 ... PSn 
as shown in Figure 5) can preferably transmit its broadcast on an assigned unique multicast 
channel corresponding to a particular multicast address (e.g., Ml, M2... Mi), and the respective 
broadcasted content is provided to this address. As discussed above, the assigned multicast 
address, along with few other relevant parameters, are announced to a global multicast address 
(Mx). 
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II. Antenna Server(RAS)/Local Station 

RASs 30 are generally distributed according to the population, the geographic 
area and/or some other topology. Each RAS 30 preferably offers two program tracks to a user of 
IMC 50 - the global broadcast transmitted by RSC 10 and the local broadcast provided by RSC 
30. In should be understood that RAS 30 can transmit/receive televison broadcasts. Since 
numerous global broadcast can be provided on a number of multicast channels, RSC 30 
preferably relays at least a subset of all transmitted programs in the global broadcast to IMC 50. 
The broadcast transmitted by RSC 10 is generally transmitted globally with gaps in the global 
broadcast so that the local advertisement and/or promotional content can be inserted in such 
gaps. The local broadcast may be local news segments provided by RAS 30. This scheme 
according to the present invention provides the user of IMC 50 with an ability to receive either 
the local broadcast or the global broadcast. 

RAS 30 preferably includes a Management Server (MS) 200 and a channel 
database 220. The Management Server 200 creates and/or maintains the channel database 220, 
records the statistics regarding the number of IMCs 50 that are receiving a particular broadcast at 
a particular local multicast channel, provides control tools for maintaining and modifying 
configurable parameters, and manages the interface with other devices (e.g., a RTSP server 
and/or media database, etc.). For each RAS 30, the Management Server 200 monitors the global 
index address Mx, and receives the global multicast channels Ml, M2 ... Mi (which provide the 
audio and/or video streams) that are described by the global index address Mx. 
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These multicast channels are provided in an encrypted form to RAS 30. An 
exemplary scheme to decrypt the encrypted multicast channels at RAS 30 shall be described in 
further detail below. After decrypting one or more of the global multicast channels Ml, M2 ... 
Mi, the stream provided at the address of the decrypted multicast channel (e.g., the global 
channel Ml) is rerouted to a particular local multicast channel (e.g., the local channel lm2) that is 
provided at a corresponding local address. In this manner, IMCs 50 can receive the decrypted 
stream which is provided at the global channel Ml to RAS 30. RAS 30 also maintains the 
directory services, and keeps track of the IMCs 50 that receive a particular broadcast (i.e., local 
and/or global). Hence, RAS 30 can provide pay-per-listen and/or pay-per-view channels, bill the 
subscriber using the IMCs 50 and manage them. 

III. Advertisement/Media Arrangement (AMA) 

As described above, RAS 30 may include AMA 40, or AMA 40 can be provided 
remotely from RAS 30. AMA 40 includes a Local Advertisement Server 210 (which can be an 
RTSP server). This Local Advertisement Server 210 is capable of playing local media on 
demand programs (e.g., songs and/or music videos), as well as inserting a local advertisement 
into the global broadcast during a commercial break thereof. 

IV. Internet Multimedia Client (IMC): 

IMC 50 can be a wired Internet Protocol (IP) device or a wireless IP device. For 
example, IMC 50 can be considered wired when it is connected on a LAN, and wireless when it 
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is located remote from the LAN and communicating over a wireless communications link. IMC 
50 is capable of executing application programs which monitor the local index multicast address 
Imx where data regarding the global or local program are provided. Conventional tools (e.g., 
NeVot, Vic, vat or any tool based on SAP/SDP standards) can be utilized by IMCs 50 to monitor 
the broadcasts and receive the multimedia (e.g., audio and video) streams from the local 
multicast channels 1ml, lm2 ... Imi. Using these tools, IMCs 50 may select any of the broadcasts 
(i.e., local or global) provided by RAS 30 by e.g., viewing the local multicast index address Imx 
on the displays of IMCs 50. 

Once, IMC 50 selects a particular channel, it starts sending an RTCP signal and 
receives the audio and/or video stream over UDP/IP. The protocols described herein (e.g., RTPC, 
UDP/IP, etc.) are known in the art, some of which shall be described below in a greater detail. 
After receiving the RTCP signal, the Management Server 200 starts monitoring the global 
multicast address of the global multicast channel which provides the broadcast (e.g., the radio 
program) selected by IMC 50. When the broadcast at the selected channel is detected, RAS 30 
directs it to the assigned address of the local multicast channels. The Management Server 200 
continues to transmit the broadcast content, and only interrupts the broadcast when there are no 
more IMCs 50 that are receiving and/or requesting this broadcast. 

As shown in Figure 6A, IMC 50 can be a radio having an ability to toggle 
between AM/FM broadcasts and the Internet channels, and/ or a television which can receive 
wireless and/or cable broadcasts, as well IP broadcasts. For example, it is possible to provide a 
wireless interface having UDP/IP multicast stack which can be connected to a conventional 
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portable radio or a portable television, (or utilized independently). Thus, the connection of an 
conventional radio/television receiver to the Internet can be accomplished. As an example, the 
conventional radio/television receiver includes a tuner for AM/FM broadcasts and/or for the 
television broadcasts. In addition, this radio/television receiver may include a switch (e.g., a 
mechanical switch, an electrical switch, an automatic software switch, etc.) with which the 
radio/television receiver can be converted to an Internet-ready device. Based on the SDP 
parameters of the program being broadcasted, the tuner of the Internet-ready device would detect 
the broadcasts and possibly categorized them (e.g., News, Entertainment, etc.). Advantageously, 
the categories and the available broadcasts are presented on a display screen of such device so 
that the user can select which category/broadcast he or she would like to receive. 

It is also possible to utilize a conventional speech generation/recognition system 
in connection with the Internet-ready device. For example, the device would provide the 
available broadcasts/categories to the speech generation/recognition system which would then 
generate voice-type descriptions of the broadcasts/categories. Then, the user may vocalize his or 
her selection, and the speech generation/recognition system would determine the selection and 
provide the requested action. 

B. EXEMPLARY PROTOCOLS AND OPERATION/IMPLEMENTATION 
L Protocols 

The system and method according to the present invention uses (and possibly 
modifies) the conventional protocols, i.e., SAP (Session Announcement Protocol), SDP (Session 
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Description Protocol), RTSP (Real-Time Streaming Protocol), RTP (Real-time Transport 
Protocol), TCP, UDP, IP and IP Multicast. An exemplary protocol stack utilized by the 
exemplary embodiment of the system and method is shown in Figure 6B. The network 
infrastructure can be wired and/or wireless. One exemplary implementation of this infrastructure 
can operate with LMS/MMD wireless links. 

Provided below is a short description of the primary protocols that can be used by 
the exemplary embodiment of the system and method of the present invention. 

SDP is a Session Description Protocol which is usable for multi-media sessions, 
and can be utilized as a format for a session description (generally does not incorporate a 
transport protocol). SDP is intended to be used for different transport protocols as appropriate, 
including SAP, SIP, RTSP, electronic mail using MIME extensions, and HTTP. SDP includes 
the session name and purpose, the time the session is alive, the content type (e.g., audio and/or 
video) comprising the session, information to enable reception of those content types (addresses, 
ports, formats etc.), the bandwidth to be used by the broadcast, and the contact information for 
the person responsible for session. SDP is widely used for the multicast sessions over the 
Internet. In order to assist in the advertisement of multicast sessions and to communicate relevant 
session setup information to prospective participants, a distributed session directory can be used. 
An instance of such a session directory periodically multicast packets containing a description of 
a multimedia session to a multicast address. These signals are subsequently received by potential 
participants, who can use the session description to start the tools required to participate in the 
session. Using this protocol, the sender can assign a particular bandwidth for a particular 
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application (e.g., radio and/or television broadcast). In this manner, the more popular or 
bandwidth-intensive application (e.g., television news) would use more bandwidth than non- 
popular application/broadcast. Thus, a popularity-based spectrum management can be achieved. 

SAP is an announcement protocol that distributes the session directory to the 
multicast conference sessions. An SDP datagram is part of the payload for SAP. SAP client 
which announces a conference session, periodically multicasts an announcement packet to a 
known multicast address and port. The appropriate address is determined by the scope 
mechanisms operating at the sites of the intended participants. IP multicast sessions can be either 
TTL-scoped or administratively scoped. Thus, an instance of the session directory may need to 
listen on multiple multicast addresses. The announcement contains a session description and 
optionally an authentication header. The session description may be encrypted. It is preferable to 
provide an authentication and integrity of the session announcements to ensure that only 
authorized parties modify session announcements, and to provide the facilities for announcing 
the securely encrypted sessions while providing the relevant proposed conferees with the means 
to decrypt the data streams. 

RTSP is a client-server multimedia presentation control protocol which is used 
for an efficient delivery of streamed multimedia over IP networks. It utilizes the existing web 
infrastructure (e.g., inheriting authentication and PICS from HTTP). This application level 
protocol may provide the robust streaming multimedia in one-to-many applications via unicast 
and multicast communication arrangements, and may support the interoperability between the 
clients and the servers from different vendors. The process of streaming breaks media streams 
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into many packets sized appropriately for the bandwidth available between the client and the 
server. When the client receives enough packets, the user software can be playing one packet, 
decompressing another, and receiving a third. The user can begin listening almost immediately 
without the necessity to download the entire media file. RTSP can control multiple data delivery 
sessions, and is capable of providing a way for selecting the delivery channels (such as UDP, 
TCP, IP Multicast) and delivery mechanisms based on RTP. RTSP can be used in conjunction 
with other protocols to set up and manage the reserved-bandwidth streaming sessions. 

RTP is a thin protocol which provides support for applications with real-time 
properties which can be run over UDP. RTP provides a timing reconstruction, loss detection, 
security and content identification. RTP can be used, possibly without RTCP^ in the unicast or 
multicast communication arrangements. In order to set up an RTP session, the application may 
define a particular pair of the destination transport addresses (e.g., one network address and a 
pair of ports for RTP and RTCP). In a muhimedia session, each medium (e.g., audio, video, etc.) 
can be transported in a separate RTP session with a corresponding RTCP session reporting the 
reception quality. 

RTCP may operate in conjunction with RTP. It provides support for the real-time 
conferencing of large groups on the Internet. RTCP control packets are periodically transmitted 
by each participant in an RTP session to all other participants. The feedback of the information to 
the application can be used to control the performance and for other diagnostic purposes. RTCP 
provides the following exemplary functions: 

Feedback to sending application regarding the quality of the data distribufion. 
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Identification of the RTP source. 
RTCP transmission interval control. 

Communication of the minimal session control information. 

SIP has been adopted by the industry, in many cases, as the signaling protocol for 
the Internet conferencing and telephony. SIP is a client-server protocol which provides the 
mechanisms so that the end systems and the proxy servers can provide different required services 
for setting up a proper signaling scheme. SIP creates, modifies and terminates the associations 
between the Internet systems (e.g., conferences and point-to-point calls). SIP is a text-based 
protocol similar to HTTP and RTSP, in which the requests are issued by the client, and the 
responses are returned by the server. SIP is independent of the packet layer and only utilizes a 
datagram service, since it provides its own reliability mechanism. This "light-weight" protocol is 
typically used over UDP or TCP, and provides light-weight signaling. SIP supports the unicast 
and multicast communication schemes, as well as combinations of thereof It can implement a 
variety of the conference-related services with a small set of handling primitives. 

11. EXEMPLARY IMPLEMENTATION USING THE PROTOCOLS 

The general implementation of an exemplary embodiment the system and method 
according to the present invention has been already described above. An exemplary 
implementation of the system and method utilizing the above-discussed protocols is as follows. 
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a. Channel Announcement 

With reference to Figure 5, according to the present invention, a particular RSC 
10 may send its program live on a unique global multicast channel (e.g., Ml) globally scoped 
and encrypted using RTP/UDP. Other RSCs 10 can also broadcast their programs on other global 
multicast channels. Indeed, the multicast channel address is different for each broadcast and/or 
for each RSC 10. These stations send their session announcement using a subset of SDP 
parameters to the global index multicast address Mx (which can be encrypted). This common 
global multicast address contains a list of the programs that are being broadcasted by RSCs 10 on 
the communication network 20. SDP or a variant thereof can be modified to provide IMCs 50 
with additional details regarding the streaming being broadcasted. 

b. Channel Management 

Figure 7 shows a flow diagram representing an exemplary implementation of one 
embodiment of the method according to the present invention. In particular, each RAS 30 has a 
global encryption key which is used by the respective RAS 30 to monitor the global index 
multicast address (Mx) to obtain, e.g., the listing of the channels and the contents of the channels 
(step 300). Then, it is determined (e.g., using a decryption technique) if RAS 30 can receive 
some or all global broadcasts (step 3 1 0). If so, RAS 30 is then provided with an authorization to 
utilize the global broadcast on the global multicast channels Ml ...Mi provided by RSC 10 (step 
320). Either automatically or via the manual control, RAS 30 may decide to broadcast at least a 
part of the list to IMCs 50 that are associated with RAS 30. For this purpose, RAS 30 may create 
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and/or utilize the channel database 220 which contains the list of the supported channels, each 
with their appropriate attributes, to associate the global broadcast channels with the local 
broadcast channels (step 330). The subset of channel descriptions announced by each RSC 10 
provides sufficient data for generating and updating this database 220, which may be a subset of 
the list that is received from the global index multicast address Mx. In this manner, the 
association between the global and local multicast channels can be recorded in the channel 
database 220 (step 340). 

Then, it is determined if RAS 30 is also transmitting a local broadcast (step 350). 
If so, RAS 30 transmits its local programs on a specific local multicast address lm_l, and records 
this information in the channel database 220 (step 360). If it is determined in step 350 that RAS 
30 is not transmitting the local broadcast, the process proceeds to step 370, in which RAS 30 
either generates and/or modifies the information in the channel database 220 regarding the 
broadcasts (e.g., local and/or global broadcasts) which are available for IMC 50. In step 380, 
RAS 30 sends the information provided on the local index multicast address Imx for the 
announcement using SAP to its IMCs 50. RAS 30 also sends the announcement regarding its 
own local programs to the same local index multicast address Imx using SAP. The announcement 
on the local index multicast address Imx is preferably not encrypted since the RAS 30 prefers all 
its clients (i.e., the associated IMCs 50) to see what is being broadcasted by it. In an alternative 
exemplary embodiment of the method of the present invention, RAS 30 maintains a pair of 
multicast addresses for each channel to maintain an association between the global multicast 
channel address (e.g., Ml). Using the respective channels, RSC 10 provides its global program 
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on the local multicast channel address (e.g., Im2) on which the broadcast being is transmitted to 
IMCs 50 by RAS 30 (i.e., steps 330 and 340). 

Figure 8 shows a flow diagram representing yet another exemplary embodiment 
of the method according to the present invention which is executed when the information in the 
local index address Imx is provided to IMC 50. In particular, IMC 50 receives the information in 
this local index address Imx (step 400). Then, in step 410, IMC 50 may request to receive the 
broadcast from a particular local multicast channel (e.g., Im2). This broadcast can be encrypted 
or un-encrypted depending on the type of a payment model being utilized. Then, RAS 30 
determines, based on the information regarding the local multicast address being requested by 
IMC 50, whether the broadcast on the particular channel is local or global (step 420). If it is 
determined that the requested broadcasted is a global broadcast (i.e., originated from RSC 10), 
RAS 30 uses the channel database 220 to route the global broadcast from the global multicast 
channel on which the requested broadcast is being transmitted to a corresponding local multicast 
address (step 430), and the process is directed to step 450. IMC 50 continues transmitting the 
RTCP packets to the Management Server 200 of RAS 30 as long as it receives the global 
broadcast on the particular local multicast channel. It should also be noted that when the 
Management Server 220 receives the global broadcast from RSC 10 on a specified multicast 
address using RTPAJDP, it also periodically exchanges RTCP signals with RSC 10. 

If it is determined that the requested broadcast is a local broadcast (i.e., originated 
from RAS 30), RAS 30 provides the local broadcast to IMC 50 on the local multicast channel 
ImJ which is assigned for local broadcasts (step 440). If RAS 30 indicates that another broadcast 
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(either pre-recorded or live) or an advertisement should be inserted into the global or local 
broadcast (step 450), RAS 30 inserts (or plays) such broadcast and/or advertisement into the 
local multicast channel associated with the local multicast address of the global or local 
broadcasts address using, e.g., SETUP and PLAY commands (step 460). For example, the 
inserted broadcast may be either a live news broadcast or a prerecorded news broadcast. Then, 
RAS 30 provides the requested broadcast on the corresponding local multicast broadcast channel 
(e.g., Im2), either with or without the additional content being inserted into the broadcast (step 
470). Thus, for that particular period, a local manager of RAS 30 may decide to join such 
specific global multicast group, this may be done when the local manager receives the RTP 
packets from RSC 10, and generates the RTP/RTCP packets for IMC 50 on the respective local 
multicast address. 

c. Using the Protocols 

To summarize, IMCs 50 may be Internet Multimedia Clients (e.g., personal 
computers and laptops utilizing wired and/or wireless interconnect, car radios/televisions having 
the IP interface) which monitor the local index multicast address Imx to determine what is 
available. Such monitoring can be performed using SAP- and/or SDP-based tools. As described 
in the SAP specification (which is incorporated herein by reference) and as known to those 
having ordinary skill in the art, RAS 30 can update the announcement information approximately 
every few minutes. Thus, the program executed at IMC 50 may wait for few minutes before 
seeing the most updated channel information. By using SAP, this lag is either substantially 
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reduced, or even eliminated, by a caching scheme. For example, this caching scheme either 

executes the SAP receiver of IMC 50 in the background to continuously keep its cache current, 
or moves to a local SAP proxy at the startup time of IMC 50 and requests a cache dov^nload. In 
the latter case, RAS 30 essentially becomes the SAP proxy. 

When IMC 50 makes a request to listen to one of the programs listed in the 
program listing (e.g., clicks on the channel), this IMC 50 sends the RTCP signal to the local 
station manager of RAS 30. If there is a broadcast (e.g., a data stream) already playing on this 
local multicast address provided pursuant to a previous request from other IMCs 50, then this 
particular IMC 50 starts receiving the audio and/or video stream using RTP/UDP. However, if 
this is the first request for such broadcast in this local domain, then RAS joins the multicast tree 
of the corresponding global multicast address to receive the broadcast from the corresponding 
RSC 10 w^hich is transmitting the requested broadcast. RAS 30 can use a conventional 
application program (e.g., "mlisten") to determine if there is any member which is part of any 
particular multicast group that is currently transmitting broadcasts, and thus should be able to 
determine if the request is a first such request for a particular multicast group, "mlisten" is a 
conventional multicast application for monitoring the number of users joining a particular 
multicast group (e.g. receiving information from a particular multicast channel). 

d. Local Advertisement Insertion 

In accordance with exemplary embodiments of the system and method of the 
present invention, the insertion of advertisement content into the global or local broadcast 
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transmitted to IMC 50 is now described below. The system is implemented such that RSC 10 
knows the starting time and the duration of a commercial break prior to the transmission of the 
global broadcast, since it controls the time for such break. These commercial breaks can also be 
event driven. Along with the RTP packets, RSC 10 continues sending the RTCP packets to the 
global multicast address of the global multicast channel where RASs 30 are monitoring the 
streams of broadcasts. Using the RTCP report, RSC 10 provides the signal to RAS 30 which 
indicates the time and the duration of a break in the broadcast. The term "advertisement" as used 
herein includes not only the content directed to selling a product or service or to promote the 
goodwill of a commercial sponsor, but also to public service messages and announcements, 
station break announcements, promotions and/or other programming to be broadcasted. 

Upon receiving such signal, the Management Server 200 of RAS 30 requests the 
local RTSP server 210 (which is part of AMA 40) to start playing the local advertisement from a 
storage medium to a specific local multicast address which is associated with the global multicast 
address at which RSC 10 transmits the global broadcast. RAS 30 uses a set of RTSP commands, 
such as SETUP, PLAY and STOP on AMA 40. During this time, the Management Server may 
stop forwarding the RTP stream from the global multicast channel to the associated local 
multicast channel. The local advertisement runs for a time determined by the Management Server 
200 using the information received from the RTCP reports. At the end of the time for the 
commercial break, the Management Server 200 sends a STOP signal to the RTSP server 210 so 
that it stops playing on that particular multicast address. Then, the Management Server 200 
resumes redirecting the audio and/or video streams from the global multicast address to the 
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associated local scoped multicast address. Since the commercial break times for RASs 30 may 

overlap, it is possible that the RTSP server 210 could play several different local advertisements 

on the different local multicast addresses. An illustration of the exemplary implementation 

described above is shown in Figure 9. 

One implementation of the system and method for inserting the advertisements 
into the broadcasts is described in greater detail belov^. In particular, the system and method can 
use "Insert Ad Java" commands to insert local advertisements. As soon as the broadcast appears 
on the global multicast channel, it starts an InsertAd thread which listens for RTCP packets 
generated by RSC 10 (e.g., the RTCP port is one greater than the RTP port).The RTCP packets 
from RSC indicate the number of seconds remaining until the start of the advertisement, as well 
as the length thereof. InsertAd command inserts a local advertisement by switching the channel 
mode to "advertisement". When the global commercial is finished, InsertAd switches the 
channel mode back to "redirect". The list of the local advertisement files is specified inside a list 
file which are inserted using, e.g., a Round Robin scheduling scheme. 

At startup, RSC 10 initiates RsSendRTCP thread to notify RAS 30 of the 
commercial breaks. The thread sends the RTCP packets so that RAS 30 can insert local 
advertisement. The RTCP packets indicate the number of seconds remaining to the start of the 
advertisement, as well as the length of the advertisement. The start times of the advertisement are 
read in the following format (e.g., one record per line): 
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day /hour/minute/second/duration; 

day is 1 through 7 which stands for Sunday through Saturday; hour is 0 through 
23; minute is 0 through 59; second is 0 through 59; and duration is specified in 
seconds. 

Since the RTCP packets are transmitted over UDP, there may be a possibihty of a 
packet loss or an incorrect order. To address this potential problem, the RTCP packets are re- 
transmitted (e.g., one packet 4 seconds prior to the advertisement, next one -3 seconds, next one - 
2 seconds, etc. with the corresponding value in the field which indicates the time remaining until 
the start of the commercial). In addition, to allow RAS 30 to distinguish between the re- 
transmissions and advertisements, the RTCP packets have a particular sequence number. All re- 
transmissions have the same sequence number. Each advertisement has a sequence number one 
greater than the previous sequence number. 

e. User Interface for Itemized Content 

It is possible to utilize and/or modify a conventional directory structure/user 
interface referred to as "sdr" in implementing the embodiments of the system and method of the 
present invention. This directory structure/user interface can be used as a tuning mechanism for 
the wireless IP radios and/or IP television, and may be touch-tone based, voice activated, etc. 
This "sdr" structure/program (created by ISI, Meriana del Ray, CA) can be modified or extended 
to make it more customized and searchable for searching purposes. For example, "sdr" can be 
modified to categorize the content of the streaming media according to the type of program being 
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broadcasted (e.g., "game show", "news", etc.) In addition, it is possible to utilize a voice 
activated-type "sdr" according to the content type, as well as to provide a menu for a particular 
locality. Also, with a touch of a button or by pronouncing a particular word (e.g., "News"), sdr 
would provide a visual menu or a voice menu to indicate which channels are available to that 
particular locality. With another touch tone or voice activation, sdr may provide IMC 50 with 
access to the broadcast from the local multicast channel. Other features need not be further 
discussed, since they would be clearly understood to one having ordinary skill in the art. 

f. Payment Model 

There are numerous payment models that can be supported by the system and 
method according to the present invention. For example, RAS 30 may collect the fees from the 
local advertisement sponsors for broadcasting their advertisements during the commercial breaks 
while relaying the global or local station broadcasts. In addition, RAS 30 may also relay some 
pay-per-listen and/or pay-per-view programs. In this case, RAS 30 pays the global station (i.e., 
RSC 10) a fee which depends on how many listeners/viewers are listening to or viewing a 
particular program. The number of listeners/viewers can be determined from the RTCP reports 
that are generated from IMCs 50. Every RAS 30 can also broadcast its local program to IMCs 50 
with the segments of the news or some other premium programs relayed from RSCs 10. 

A different type of the pricing model can also be provided to reflect the process of 
determining when and on which channels the advertisers should place their advertisements in 
order to maximize their return on investment. Priorities can be assigned to certain advertisements 
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so as to enable the advertisers to compete for a higher time slot or timing of the advertisement 
(e.g., the highest paying company would get the slot during the Super Bowl by using a 
contention algorithm). It may also be possible to implement the exemplary payment schemes, 
e.g., public financing, advertising and on-air solicitations for donations. Hybrid models (e.g., the 
paying customers are not required to view or listen to commercial or receive solicitations for 
donations) are also feasible. Furthermore, another embodiment of the payment model can be 
associated with the security model described below. 

g. Security 

It is possible to provide at least four levels of encryption for the system and 
method according to the present invention (e.g., a global announcement encryption, a global 
multicast stream encryption, a local audit encryption and a user authentication). 

Utilizing the global announcement encryption, it is possible to separate the global 
announcements from the local announcements. IMCs 50 should not be able to gain access to the 
global announcements, and would only be able to view the local announcements. With the global 
encryption key during the announcement (by RSCs 10), IMCs 50 would not be allowed to find 
out about available the global channels, and thus such scheme provides a control over to RSC 10 
to announce only a subset of these channels to IMCs 50 via RASs 30. However, if some stations 
do not want to encrypt their contents and session announcements at all, this security model 
should effectively prevent IMCs 50, as well as the nonpaying RASs 30, from receiving the 
broadcast from those designated stations. Thus, each RSC 10 should maintain a secret key, and 
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encrypt all outgoing content so that only a ciphertext stream is transmitted. In particular, the 
concept is to generate a symmetric encryption key at RSC 10, and securely distribute this key to 
a particular RAS 30 upon payment of the required fee. There are many ways this key can be 
distributed to the local stations, as is known to those having ordinary skill in the art. 

The global multicast stream encryption can be extended to RAS 30 as a second 
level hierarchy. Some of the pay-per-listen and/or pay-per-view programs can be announced to 
the local multi-cast addresses in any domain using the encryption key so that an appropriate fee 
collection procedure can be established for the IMCs 50. Any type of encryption can be applied 
to the audit data of RAS 30, so as to preserve the sensitive information such as the secret keys of 
RSCs 10, the information for the pay-per-listen and/or pay-per-view channels, the user accounts, 
and the payment data. The advertising entities can be authenticated so that unauthorized 
companies could not gain access to AMA 40. 

In practice, each RAS 30 generates its own Public Key/Private Key pair. Each 
RSC 10 generates an SEK key, and begins transmitting the encrypted audio and/or video content. 
This SEK key should be distributed to the participating RASs 30 in a secure way so that other 
RASs 30 (which did not pay) cannot obtain this key. As such, the Public Key technology is 
employed for this purpose. RAS 30 submits the Public Key to RSC 10 along with its payment. 
Then, RAS 30 receives an Integer ID from RSC 10 which is later used to index the SEK 
distribution list. RSC 10 collects the Public Keys from RAS 30 and adds these keys to its SEK 
distribution list upon their payment. 
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h. Logging Mechanism 

One of the purposes of providing a logging mechanism for the system and method 
of the present inventions is to provide a process for the advertisers to determine when and on 
which channels to place their advertisements so as to maximize their returns on investment. 
RTCP is well suited for allowing RAS 30 to collect user-specific and channel-specific listening 
information. In one embodiment, RAS 30 constantly monitors the number of users receiving the 
broadcast on each channel, as well as the type of content being transmitted (i.e., the 
advertisements as opposed to the real content). This is especially advantageous for payment 
purposes by the advertiser to the local station when the users join or leave the local multicast 
group at the time when the advertisement starts/stops playing. When RAS 30 detects an 
"audience change " (i.e., a change in the number of listeners or the type of content), h 
encapsulates this information into a particular structure, and passes it to the separate logging 
thread for storing into the log files. The logging thread in turn, buffers this information and 
periodically writes out the contents of the buffer, in a binary format, to the log files (using a Java 
serialization). 

The above-described features - i.e., separate logging thread, output buffering, and 
binary (as opposed to text) logs - enable a quick output to avoid an interference with the quality 
of the audio and/or video transmission at run-time. In addition, these features allow for a good 
scalability as the number of the receivers of the broadcasts increase. A report generation tool 
can also be used to inspect the log files, and generate the statistics in a format that can be 
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presented to the user. Such tool may support various commands, such as line options that control 
the way the tool interprets the log and presents its contents to the user. 

C. NON-MULTICAST ENABLED NETWORK 

The multicasting environment can be implemented for all segments within the 
system and method of the present invention. Although it may be simpler to implement the 
multicast communication in the Intranet or within an autonomous system (e.g., a separate 
domain), in the past the multicast support between the autonomous systems has not been readily 
available. To extend the above-described functionality to a network where the multicast 
communication is not supported, it may be preferable to provide another embodiment of the 
system and method according to the present invention which is based on the user level or the 
network level application level. 

L Multicast Tunneling - Network Layer Solution 

If there is a lack of the multicast connectivity between some portions of the 
network, the multicast connectivity can still be used by establishing a multicast tunnel between 
two different networks using the edge routers. In order to establish the multicast tunnel, it is 
preferable to provide at least one server running a multicast routing daemon in each such 
network. However, since this approach is a network layer solution, it may also be preferable if 
some of the hosts would be running the multicast routing daemon. This approach may also 
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assume that there is a mutual understanding (i.e., interconnectivity) between several connectivity 
providers. 

11. UDP servers - User Level Solution 

It may be easier to implement the multicast communication within the Intranet. 
Since the multicast communication is not yet widely deployed over the wide area network (i.e., 
some of the intermediate routers may not support the multicast communication), the multicast 
connectivity between portions of these autonomous systems may not currently exist. Figure 10 
shows an exemplary configuration where there is no multicast connectivity in the wide area 
network, but the multicast communication is enabled within the local area.' Thus, there may be 
islands of multicast enabled networks, but there may not be any multicast connectivity between 
the islands. In this exemplary configuration, a UDP Server 550 is provided. This UDP Server 
550 is co-located with RAS 30. It is also possible that its functionality is provided in the 
Management Server 200. This UDP server 550 can use a modified version of "rtptrans" which 
allows a conversion of the audio and/or video stream from the multicast network type to the 
unicast network type, and vice-versa, "rtptrans" is a conventional RTP translator application 
which copies RTP packets from any number of unicast and multicast addresses. Alternatively 
these servers can use "UDP Multicast Tunneling Protocol" (UMTP) which can set up a 
connection between the multicast enabled islands by tunneling multicast UDP datagrams inside 
unicast UDP datagrams. 
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In particular, whenever any radio station wants to announce its program to the 
Internet, or if any system wants to broadcast content to the Internet, these devices register with 
the nearest antenna server. This can be done as described above, where each broadcaster will 
send its announcement on a specific multicast address in the local domain, and RAS 30 will 
receive the announcement through SAP. Each RAS 30 is responsible for maintaining a database 
of the program profile of the set of radio stations announcing in the same domain. If there is no 
multicast connectivity between antenna servers over the wide area network, then RASs 30 would 
update each other's program schedules which can be categorized according to, e.g., the News 
type. Thus, at any point in time, each RAS 30 will have the program schedule of all RSCs 10 
broadcasting globally, in addition to its own local program if RAS 30 is broadcasting the local 
program. 

IIL Utilization of UDP Multicast Tunneling Protocol (UMTP) 

In order to extend this multicast connectivity to all the autonomous systems, 
LTD? servers that execute the convention UDP Multicast Tunneling Protocol can be 
implemented for a use with the system and method according to the present invention. For 
example, the UDP Multicast Tunneling Protocol establishes a connection between two end-UDP 
servers by tunneling the multicast UDP datagrams of the respective domain inside unicast UDP 
datagrams. Each UDP server is located within the autonomous system and that autonomous 
system is multicast capable. In this case, both the end points of the tunnel act as masters. 
Whenever a tunnel endpoint - whether a master or slave - receives a multicast UDP datagram 
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addressed to a, e.g., group, port, etc., that is currently being tunneled, it encapsulates this 
datagram, and sends it as a unicast datagram to the other end of the tunnel. Conversely, whenever 
a tunnel end-point receives, over the tunnel, an encapsulated multicast datagram for a group or 
port of interest, it decapsulates it and resends it as the multicast datagram. 

Each UDP server in an autonomous domain listens to the local common multicast 
address to find out the announcement within its domain, and passes it to the other UDP servers in 
other domain within an encapsulation. Another UDP server, after receiving the local multicast 
address, decapsulates and announces it on the local multicast address in the other domain. These 
UDP servers keep listening to each other periodically to update the announcement status. Thus, 
at any particular point in time, each client knows the program status of several programs that are 
playing within various domain. If a client prefers to listen to a particular program playing in a 
different domain, it makes a request on the local common announcement bus. The local UDP 
server receives the request, and passes this request to the corresponding UDP server in the proper 
domain. The remote UDP server sends the encapsulated stream on a unicast address, and the 
local UDP server sends it on the appropriate multicast address in the local domain. It is 
preferable if there is no overlapping of the multicast addresses with those provided in a different 
zone (e.g., a zone provided remote from the zone which provide the information on the multicast 
channel). 
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IV. RTP Trans 

It is also possible to provide an RTPTrans server which converts the multicast 
stream to the unicast stream, and vice versa. A dedicated RTPTrans server can be provided in 
each area. Alternatively, the RTPTrans server can be a part of RAS 30. For example, the RSCs 
10 in the local area transmit programs to the specified multicast addresses, and send their 
announcements to the common multicast address. The local RTPTrans server listens to these 
announcements, and send them to other RTPTrans servers located in different areas, w^here the 
announcements are transmitted to the common multicast announcement address in that specific 
area. Thus, when RAS 30 listens to the common multicast address using SAP, it can obtain the 
program listing of RSCs 10 in other areas, in addition to the listing in its own area. The RTPtrans 
server receives the unicast audio and/or video stream from each RSC 10 via other RTPtrans 
server, and multicasts it on a specific multicast address corresponding to the remote radio station. 

D. MOBILITY MANAGEMENT 

Another embodiment of the system and method according to the present invention 
provides a Mobility Management (MM) technique. This technique is especially preferable when 
IMCs 50 are mobile and wireless. Thus, e.g., area 1 may be covered by one RAS 30 provided 
one subnet, and area 2 may be covered by a second RAS 30 provided on another subnet. As the 
mobile and wireless IMC 50 moves from area 1 to area 2, it is essential for the mobile IMC 50 to 
continue receiving (i.e., without significant interruptions) the broadcast it was receiving from 
RAS 30 covering area 1 . As shall be described in further detail below, one way to accomplish 
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such uninterrupted broadcast is to imitate the streaming of the broadcast that the mobile IMC 50 
has been receiving in area 1 into area 2. RAS 30 in area 2 should have adequate information 
about the mobile IMC 50 traveling into area 2 so that it can now begin streaming with virtually 
no perceived discontinuity in the broadcast to the mobile IMC 50. Provided below is a 
description of possible approaches to address the triggering of the multicast streaming in the 
wireless environment when the mobile IMC 50 moves from one subnet to another. 

As described above, each RAS 30 may have two interfaces having respective 
addresses, one can be a global address and other maybe a local address. It is also possible to 
utilize one interface for both address configurations. As shown in Figures 1 1 A and 1 IB, 
symbols la, lb, Ic represent globally knovm subnets (e.g., globally addressable subnets) 
connected to one of the interfaces of respective RAS 30, while symbols ia, ib, ic represent the 
local subnets (or cells) connected to the secondary interfaces of RAS 30, and could be local to 
that particular area.. 

In operation, RAS 30 receives the multicast stream through its global interface 
and redirects it out through the local interface for IMC 50 in each cell. In the exemplary 
implementation shown in Figures 1 1 A and 1 IB, symbols SI, S2 ... S5 represent servers (or RASs 
30) which are connected to upstream routers. Each server (with the exception of S2 and S3 which 
are connected to the same subnet via a multicast switch) is connected to a different subnet, and to 
a separate interface. Each server is assigned to one particular cellular region, which can be a part 
of a private subnet dedicated for the local user. The base stations are not shown in Figures 1 1 A 
and 1 IB for the sake of simplicity of the depiction. These base stations can be IP based. It is also 
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possible for the servers to behave as the base stations on one of its local interfaces (e.g. having 
dual interfaces). It is also possible to connect the second interface of the server to a non-IP based 
base station (e.g., a layer-2 base station), which would perform the handoff. In the illustrated 
implementation, the servers S2 and S3 are connected to a multicast switch, which then becomes a 
part of the same subnet that can manage the traffic using GSMP. GSMP is a General Switch 
Management Protocol which can be used in multicast transmissions at a switch level. Using 
GSMP, is possible to save the bandwidth of an adjacent cell if both cells are part of the same 
subnet. Different exemplary schemes to effectuate the handoff of the broadcast when the mobile 
IMC 50 moves from area 1 to area 2 (i.e., from subnet S3 to subnet S4) shall be described in 
further detail below. 

I. Post-Registration 

The post-registration approach is the easiest approach. However, it may take a 
long time for the same multicast stream to be directed in the new cell. In an exemplary scenario, 
the mobile IMC 50 move to a new cell (i.e. from cell ib to cell ic), obtains the new IP address if it 
is moving to a new subnet, and then sends the join query via RTCP or IGMP scheme. In this 
case, there may still be a latency during hand-off This latency can be avoided by other schemes 
described below. 

Popularity based spectrum management to address the limits of spectrum, e.g., a 
control mechanism to manage an audio/video stream based on a popularity of the program. 
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In an implementation of an exemplary embodiment of the system and method 
according to the present invention, the mobile IMC 50 moves to an adjacent cell (i.e., from cell 
ib to ic), obtains a new IP address via a multicast address dispenser server if it is moving to a 
new subnet, and sends a "join" message via RTCP or IGMP scheme. After the handover, the 
mobile IMC 50 would continue to receive the multicast streaming content in the new subnet if 
there are other active participants in that adjacent cell receiving the content which the mobile 
IMC 50 wants to receive. If there is no participants which receive a particular streaming content 
in the adjacent subnet into which the mobile IMC 50 moves into, then the mobile IMC 50 joins 
the group by itself after receiving the query from the "first-hop" router (e.g., the router to which 
the mobile IMC 50 is directly connected to). 

It takes some time for the mobile IMC 50 to configure itself after the move, and 
then join the group. For example, the mobile IMC 50 may wait for 70-75 seconds to receive the 
multicast traffic it was previously receiving after a handover. It is also possible to use a discovery 
agent to discover that the mobile IMC 50 has moved to another subnet (i.e., the mobile IMC 50 
received a new address). This determination may triggers the above-described joining scenario. 

Advantageously, the above-described handover timing can be reduced by 
exploiting a fast reconfiguration and join time using RTCP (via application layer triggering). For 
example, if the adjacent cell is not a new subnet , then the mobile IMC 50 does not need to be 
reconfigured. Indeed, the mobile IMC 50 retains its IP address, and the triggering procedure can 
still be activated using RTCP by utilizing a variation of GSMP. Otherwise, the streaming content 
would already be flowing in the adjacent cell via the multicast communication technique. 
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11. Pre-Registration 

Each station (e.g., the servers SI, S2 ... S5) can have multiple neighboring stations 
(i.e., also servers). For each of these station being shared with another station, it is preferable to 
issue a multicast announcement (e.g., a multicast address), where each station can determine the 
program subscribed to, e.g., the group address used by the mobile IMC 50. Just before IMC 50 
leaves (or decides to leave) the current cell (a determination which could be based on the 
threshold value of the received signal), this IMC 50 sends an RTCP message to the local server. 
The local server then announces this RTCP message to the sharing multicast addresses, where 
the neighboring stations would be listening to in the global space. The neighboring stations (e.g., 
servers) connect to the multicast address, and verify it with the information in their own database 
to determine if this stream has already been transmitted (e.g., if the particular group has already 
been subscribed to). If another client have been listening to the same stream, then nothing is 
done. If the broadcast is not being transmitted, then RAS 30 sends an IGMP message to the 
upstream router, and passes the stream to the local cells using a local multicast address, even 
before the mobile IMC 50 moves to the new cell. Thus, a soft hand-off is emulated for the 
associated stream. As soon as the mobile IMC 50 moves to the next cell, it can still receive the 
same stream without any interruption. The mobile IMC 50 sends an RTCP BYE message to the 
server as it move away from the previous server. 
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III. Pre-Registration with Multicast Agent 

In this scheme, a multicast agent is utiHzed to take care of the multicast stream. 
The multicast agent can be provided within each router, which sends these streams to the 
respective global multicast addresses (e.g., for the area where these clients are trying to move in) 
in each subnet for a specific period of time, as determined by a timer associated with the subnet. 
Thus, each neighboring server receives the stream irrespective of whether the mobile IMC 50 is 
moving into that cell or not. As soon as the mobile IMC 50 moves into the new cell, it sends an 
RTCP signal to alert that the mobile IMC 50 has moved in, thus the timer does not need to be 
triggered. 

IV. During Registration 

In another scheme according to the present invention, this information can be 
passed on, as a part of a registration method. When the mobile IMC 50 moves in and attempts to 
acquire the address in the local subnet, it can send the request for that stream in its DHCP option 
regarding the address it has been listening to. However, in that case, the server may also be a 
registration server. Thus, at the time of obtaining the IP address from the DHCP server, the 
mobile IMC 50 can send the local multicast address to the server, and depending on whether the 
server is already a part of the multicast tree, it would ignore this request or re-join the tree. 
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V. Proxy Registration 

Another scheme can deploy a proxy agent in each subnet. These proxy agents join 
the upstream muhicast tree on behalf of the servers, even before the mobile IMC 50 moves into 
the cell. The neighboring proxy server would then listen to a common multicast address to 
determine the impending host's subscribed multicast address. 

The foregoing describes exemplary embodiments of the present invention. 
Various modifications and alterations to the described embodiments will be apparent to those 
skilled in the art in view of the teachings herein. For example, the system and method according 
to the present invention can also be used for either wired or wireless teleconferencing over the 
Internet using at least in part the multicast communication technique. It will thus be appreciated 
that those skilled in the art will be able to devise numerous systems and methods which, although 
not explicitly shown or described herein, embody the principles of the present invention, and are 
thus within the spirit and scope of the present invention. 
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} 



} 
} 

catch <InterrupteciException e) { 
} 

/**/ 

// let other channels (threads) run (time-slicing) 
//Thread. yieldO ; 



} 



/* 

* RTCP listener thread running. 
*/ 

while (Thread. currentThread () =« rtcpThread) { 

//System. out .println (obj_name + ".run: channel-" + chanID + " num ircs=" + rtcpRe 
gistry .getNumMembers () ) ; 

// determine whether or not to start the channel thread 
if (lisOnlineO && rtcpRegistry .getNumMembers () > 0) { 
try { 

start 0 ; 

System. out .println (obj_name + ".run: channel-" + chanID 

+ " started" ); 

} 

n catch (Exception e) { 

^ System. err .println (obj_name + 

".run: cannot start channel-" + chanID); 

} 

} ^ 



S // determine whether or not to stop the channel thread 

p if (isOnlineO && rtcpRegistry .getNumMembers () ~ 0) { 

£ stopO; 

System. out .println (obj_name + ".run: channel-" + chanID 

+ " stopped"); 

yj /* uncomment below to use variable sleep feature, (and comment above) 

M: * Sleep, (accordingly wrt # of running channels) 

m */ 

Thread. sleep (threadCounter. getSleepTime 0 ) ; 

synchronized (this) { 

while (threadSuspended && channelThread != null ) { 
wait ( ) ; 

} 

} 

} 

catch (InterruptedException e) { 
} 

/**/ 

// let other channels (threads) run (time-slicing) 
//Thread.yieldO ; 

} 

} 

/** 

* Starts the broadcast thread for this channel. The channel will begin 

* to listen on its content provider's data stream and do its protocol 

* process (strip-off header, check for special packet, decrypt, etc.) 

* and broadcast (multicast) the remaining audio data to all clients tuned 

* to this channel. 
★ 

* Gexception TooManyChannelThreadsException if too many 
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* <^^P>channelThread</code>s are rux^^f^ (broadcasting) . 
*/ 

public synchronized void start () throws TooManyChannelThreadsException { 

if ( ! isOnline 0 ) { 

if (g_maddr != null && threadCounter , addThread ( ) ) { 
System, out .println (ob j_name 

+ ".start: initializing channel-" 
+ chanID) ; 

// create sockets & join group 
try { 

send_msoclc = new MulticastSocket () ; 

recv_msock = new Mult icastSocket (MarconiServer . RSC_PORT) ; 
recv_msock. joinGroup (g_maddr) ; 

} 

catch (lOException e) { 

System. err .println (obj^name + ".start:"); 
e. print StackTrace () ; 

} 

// start channel announcement thread 
channelThread = new Thread (this) ; 
channelThread. start () ; 

} 

else { 

throw new TooManyChannelThreadsException 

(obj_name + ".start: too many threads running"); 

} 

} 

else { 

throw new IllegalThreadStateException 
(ob j_name 

+ ".start: broadcast thread already running for channel-" 
+ chanID) ; 

} 

} 

/ * * 

* Stops the broadcast thread for the channel* The channel itself is not 

* to be destroyed. 
*/ 

public synchronized void stopO { 

if (isOnline ()) { 

if (threadCounter.removeThreadO ) { 

// free sockets & threads 
try { 

channelThread = null; 
while (SOCKET_IN_USE) { 
Thread. sleep (3) ; 

} 

recv_msock,leaveGroup (g_maddr) ; 
recv_msock. close 0 ; 
send_msock. close () ; 

} 

catch (Exception e) { 

System. err, println (obj_name + ".stop:"); 
e. print StackTrace 0 ; 

} 

finally { 

notify 0 ; 

} 
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} 

else { 

// do nothing 

} 

} 

else { 

throw new IllegalThreadStateException 
(ob j_name 

+ ".stop: broadcast thread not running for channel-" 
+ chanID) ; 

} 

} 

/** 

* Stop all threads and destroy this object, 
*/ 

public synchronized void destroy () { 
stop 0 ; 

rtcpThread = null; 
rtcpListener . stop ( ) ; 
rtcpRegistry .close 0 ; 

} 

/** 

* Temporarily suspends the running broadcast thread. 
^ */ 

!ppublic synchronized void suspend () { 

'>0 if (isOnlineO) i 

gi threadSuspended = true; 

;p notify 0; 

5 else { 

4= throw new IllegalThreadStateException 

^ (obj_name 

Q + ".suspend: broadcast thread not running for channel-" 

+ chanID) ; 

W * Resumes the broadcast operation, 
*/ 

public synchronized void resume () { 

if (isOnlineO) { 

threadSuspended = false; 
notify 0 ; 

} 

else { 

throw new IllegalThreadStateException 
(ob j_name 

+ ": broadcast thread not running for channel-" 
+ ChanID) ; 

} 

} 

/** 

* Tests to see if thread is running (i.e. channel is broadcasting) 

protected synchronized boolean isOnlineO { 

return (channelThread != null) ? true : false; 

} 
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DaH&sting process. Registers (make^B> 



* Initializes broSKsting process. Registers (make^^yment ) with the radio 

* station to obtain the SEK. Set key pair (public/private) . 
★ 

* @param pubKey public key of RAS, as given by <code>MarconiServer</code> . 

* Qparam privKey private key of RAS . 
V 

protected synchronized boolean init(byte[] pubKey, byte[l privKey) { 
this.publicKey = pubKey; 
this .privateKey = privKey; 
try { 

System. out .print In (obj_name + ",init: contacting RSC at " 

+ host + "..•"); 
station = (RSC) Naming, lookup ("//" + this. host 

+ + MarconiServer .RMI_PORT 

+ " /marconi . rsc . station" ) ; 
sek_id = station. enroll (publicKey) ; 
System. out .println (obj_name 

+ ".init: public key submitted (sekid=" + sek_id + ")"); 

} 

catch (Exception e) { 
return false; 

} 

if (sek_id > -1) { 
return true; 

Q ) 
m else { 

in return false; 

} 



} 



yj / ★ * 

ffl * Adds individual commercial into the channel database. 

* @param ad_id advertisement id or commercial filename. 

h ^/ 

H protected synchronized void addCommercial (String ad_id) { 

H // set date using the time at GMT at 0 hour (midnight) 

ffi Date date = new Date (Timestamp.get_midnight () ) ; 

o 

^ if ( ! commercialSchedule.containsKey (date) ) { 

Vector2 ad_list new Vector2(); 
commercialSchedule.put (date, ad_list) ; 

} 

Vector2 ad_list = (Vector2) commercialSchedule .get (date) ; 
ad_list .addElement (ad_id) ; 

} 

/ * * 

* Removes the list of commercials in the database. 
*/ 

protected synchronized void removeCommercials () { 

// set date using the time at GMT at 0 hour (midnight) 
Date date « new Date (Time stamp. get_midnight ()) ; 

if (commercialSchedule.containsKey (date) ) { 

Vector2 ad^list = (Vector2) commercialSchedule. get (date) ; 
ad_list .removeAllElements () ; 

} 

} 

/** 
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* Generates a commercia^^st file from the channel datal^^. This file consists 

* of a list of filenamel^B be read-in by the advert isem^^r insert ion module. Each 

* file in the list should contain the actual audio data for the commercial playing 

* and its name is added to the database via. <code>addCommercial 0 </code> method. 

* The commercial-list file takes the global multicast address of this station in 

* numerical format appended by ".1st". 
*/ 

protected synchronized void genCommercialFile ( ) { 
Date date - new Date (Timestamp.get_midnight {) ) ; 

if (commercial Schedule. containsKey (date) ) { 
try { 

File file = new File (g_maddr .getHostAddress ( ) + ".1st"); 

PrintWriter fout = new PrintWriter (new Buff eredWriter (new FileWriter (f ile) ) ) ; 

Vector2 ad„list = (Vector2) commercialSchedule .get (date) ; 
String[] ad_arr = ad_list . toStringArray ( ) ; 
if (ad_arr 1= null) { 

for (int i = 0; i < ad_arr . length; i++) { 

fout.println( (ad.arr [i] != null) ?ad_arr[i] : ""); 

} 

System. out .println (Ob j^name + ".genCommercialFile: file updated -" 

+ new Date 0 ) ; 

fout .close 0 ; 
m catch (lOException e) { 

m > 

is! : 

W/ * * 

0^ * Returns channel statistics. 
* 

* Qreturn channel accounting information packaged in <code>ChannelStatistics</code> 

* class. 

m */ 

"^'protected synchronized ChannelStatistics audit () { 

^ return new ChannelStatistics (String .valueOf (chanID) , rtcpRegistry .getNumMembers ( ) ) ; 

;™: / ★ * 

^ * Reads from a CDP packet and extracts channel information. 

* Gparam cdp the channel description packet to be parsed. 
V 

protected synchronized void read_cdp (CDPPacket cdp) { 
if (cdp. name !«» null) { 
this. name - cdp. name; 

} 

if (cdp.category !- null) { 

this. category = cdp. category; 

} 

if (cdp. description != null) { 

this. description = cdp. description; 

} 

if (cdp. language !=* null) { 

this. language =» cdp. language; 

} 

if (cdp. origin null) { 

this. origin = cdp. origin; 

) 

if (cdp.MADDR 1= null) { 
try { 
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this.^^^dr = inetAddress ,getByName (cdJ^^^DR) ; 

catch (Exception e) { 

} 

} 

if (cdp.id != null) { 
this. host = cdp.id; 

} 

if (cdp.SEKLIST != null) { 

if (sek^id >= 0 && sek_id < cdp . SEKLIST . length) { 
if (cdp. SEKLIST [selc_id] != null) { 
SEK = new byte [SEKLEN] ; 

byte[] temp_byte = Base64 .decode (cdp. SEKLIST [sek_id] .getBytes ()) ; 
System. arraycopy (temp_byte, 0, SEK, 0, 

Math. min (temp_byte. length, SEKLEN) ) ; 

} 

} 

} 

if (cdp. date -1 && cdp. schedule != null) { 

// set date using the time at GMT at 0 hour (midnight) 
Date date = new Date (Timestamp.get_midnight (cdp. date) ) ; 

// store schedule 

programSchedule .put (date, cdp . schedule) ; 



|il * The commercial database design is not utilized in this version. 

* Instead, refer to genCommercialFile () and its related methods for 
^ * supporting LAIP (local advertisement insertion protocol) . 

_ J * 

5 commercialSchedule. put (date, new CommercialSchedule () ) ; 

4- } 
} 

U /** 

^; * Writes current channel information to a CDP packet. The scheduling 

* information is only done for the current date. Thus the server is not 

* supported to post announcements for future dates. 

Q 

O * @return a fully initialized CDP packet. 

" V . 

protected synchronized CDPPacket write_cdp () { 
CDPPacket cdp = new CDPPacket () ; 



// get today's date at 0 hour. 

Date today « new Date (Time stamp. get_midnight ()) ; 

// copy channel info 

cdp. name * this. name; 

cdp. category = this. category; 

cdp.id = String. valueOf (this .chanID) ; 

cdp. description = this .description; 

cdp. origin = this. origin; 

cdp. language = this , language; 

cdp.MADDR = this.l_maddr.getHostAddress() ; 

cdp.MPORT = MarconiServer . IRC_PORT; 

cdp.MTTL - MarconiServer .LOCAL_TTL; 

// copy schedule info 

cdp. date = today .get Time () ; 

String sched = (String) this .programSchedule .get (today) ; 
cdp. schedule = (sched null) ? : sched; 
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return cdp; 
} 

} 

/** 

* The <code>ThreadCountManager</code> class implements the operations done 

* on the number of running threads. It defines the maximum number of threads 

* (i.e. channels). It also calculates the announcement interval time by taking 

* number of channels into account. 

* <p> 
* 

* Gauthor -riK, 

* ^version $Revision: 1.0 $ 

* Gsince prototype 1.0 
*/ 

class ThreadCountManager { 



int threadCount = 0; 

public final static int MAX_THREADCOUNT = Marconi Server .MAX_CHANNELS; 
final static int MAX.SLEEPTIME = 200; 
final static int MIN_SLEEPTIME = 20; 



-7** 

O * Increments the thread counter. 
\0 */ 

'Ifprotected boolean addThreadO { 

^ if (threadCount < MAX_THREADCOUNT) { 

~ threadCount++; 

^: return true; 

2 > ' 

return false; 

f } 

~ * Decrements the thread counter. 

*/ 

^protected boolean remove Thread () { 
\y if (threadCount > 0) { 
g threadCount — ; 

Q return true; 

} 

return false; 

} 



* Tells whether there are no threads. 
V 

protected boolean isEmptyO { 

return (threadCount ==0) ? true : false; 

} 



* Returns the number of running threads. 
V 

protected int getCountO { 
return threadCount; 

} 



/ * * 

* Returns each thread's appropriate sleep time in number of milliseconds. 

* The more threads running, the less sleep time for each thread. 
*/ 
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a^^lkx_SLEEPTIME - threadCount * lO^^I 



protected int geti 

return Math .ma ^^Rkx_SLEEP TIME - threadCount * lO'^^IN.SLEEPTIME) ; 

} 

} 
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/* marconiNet - Internet Rad^^etwork 

* Distributed Radio Antenna ^Ifver (RAS) : (Channel Monitorin'^fpplet ] 

* $<marconi.ras.>ChannelMonitorApplet .java -v2 . 0 (prototype version), 1999/05/22 $ 

* @jdkl-2, -riK. 
*/ 

package marconi . ras; 

import java. applet .Applet ; 

import java . awt • * ; 

import j ava . u t i 1 . * ; 

import java . net . * ; 

import java.rmi.*; 

import java . rmi . server . * ; 

/ ★ * 

* The ChannelMonitorApplet exports a remote object, and periodically contacts RAS 

* to obtain channel accounting information and plots it in graph format. 
*/ 

public class ChannelMonitorApplet extends Applet 
implements Runnable { 
final static int INCR = 10; 
final static int GRIDLEFT = 150; 
private static int WIDTH = 600; 
jprivate static int HEIGHT = 350; 

tflDrivate static String title = ""; 

ilffinal static String obj_name = "marconi . ras .ChannelMonitorApplet ; 
^JThread updateThread = null; 

private Hashtable channelTable = new HashtableO; 
private RAS rasServer = null; 

gi 

/ * Updates channel status. 

Spublic void update () { 

ChannelStatistics [] channels = null; 
H try { 

^ channels = rasServer .getStatistics () ; 

Q System. out. println (Ob j_name + ".update: " + new DateO); 

a > 

~ catch (RemoteException e) { 

for (int i = 0; i < channels . length; i++) { 

if (channels[i] != null) { , w 

ChannelData data » (ChannelData) channelTable .get (channels [i] .chan_id) ; 

if (data != null) { 

data. update (channels [i] ) ; 

} 

} 

} 

repaint (); 

} 



/** 

* Periodically update. 
*/ 

public void run() { 

while (Thread. current Thread 0 updateThread) { 

try { 

Thread. sleep (10000) ; 

} 

catch (interruptedException e) ( 
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} 

update ( ) ; 
} 

} 

public void start () { 

updateThread new Thread (this) ; 
updateThread . start ( ) ; 

} 

public void stopO { 

updateThread = null; 

} 

/ ★ * 

* Initializes the applet. 
*/ 

public void initO { 
try { 

// lookup RAS server 

URL URLbase = getDocumentBase ( ) ; 

System, out .println (obj__name + ".init: looking up RAS"); 
rasServer = (RAS) Naming. lookup ( "//" + URLbase . getHost ( ) + 

+ getParameter ("RASPort") 
fi + "/marconi .ras .MarconiServer " ) ; 

ip catch (Exception e) { 

e. print StackTrace () ; 

^ } 

m 

£0 ChannelStatistics [ ] channels = null; 

Si try { 

.?= channels = rasServer .getStatistics () ; 

^ System. out -println (obj_name + ".init: " + new Date () ) ; 

U ■ ■ > 

catch (RemoteException e) ( 
01 e. print StackTrace 0 ; 



■ill 



for (int i = 0; i < channels . length; i++) { 

if (channels [i] != null && ! channelTable . containsKey (channels [i] • chan_id) ) { 

channelTable. put (channels [i] .chan_id, new ChannelData (channels [i] .chan_id)); 

} 

} 

setBackground (Color .white) ; 
setLayout (null) ; 

// draw checkboxes 
int i = 0; 

Enumeration enum =* channelTable .elements () ; 
while (enura.hasMoreElements () ) { 

ChannelData data » (ChannelData) enura.nextElement () ; 

SmartCheckbox cb « new SmartCheckbox (data, this); 

data.cb = cb; 

add(cb) ; 

validate () ; 

cb, set State (data. displayed) ; 

cb. set Bounds (10, i++*30+25, 60, 18); 

} 



} 



* Called when applet is destroyed. 
V 
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public void destroy 0 { 

} 

/** 

* Paints the panel. 
*/ 

public void paint (Graphics g) { 

// draw title 
g.setColor (Color. black) ; 

g. drawstring ("Channels monitored:", 10, 10); 

// draw grid lines 

g. setColor (Color .darkGray) ; 

for (int i = GRIDLEFT; i < WIDTH; i += 50) { 
g.drawLined, 0, i, HEIGHT - 50); 

} 

for (int i = 0; i < HEIGHT; i += 50) ( 

g.drawLine (GRIDLEFT, i, WIDTH - 50, i) ; 

} 

g. setColor (Color .black) ; 
for (int i = 0; i < HEIGHT; i += 50) ( 
int X - i / 2; 
if (X >- 100) X = 24; 
□ else if (X >= 25) x = 17; 

.f-. else X = 10; 

g.drawString (String. valueOf (i/2) , GRIDLEFT - x, HEIGHT - 50 - i) ; 

0^ // draw channels 

S Enumeration enum = channelTable. elements () ; 
gi while (enum.hasMoreElements () ) ( 

ChannelData data = (ChannelData) enum.next Element () ; 

L. int size; 

O ChannelStatistics [] updates; 

ff^ synchronized (data .updates) { 

1=^ size = data.updates.size 0 ; 

updates = new ChannelStatistics [size] ; 

data. updates. copy Into (updates) ; 

g.setColor (data. color) ; 
if (data. displayed) ( 

// draw box around checkbox if mouse is over it 
if (data.cb null && data.cb.haveMouse () ) { 
Point p = data. cb.getLocat ion 0 ; 
Dimension d - data. cb. get Size () ; 

g.drawRect (p.x-1, p.y-l, d.width+4, d.height+4) ; 

g.drawRect (p.x-2, p.y-2, d.width+4, d.height+4); 



// point to graph for stock 
if (size > 0) ( 

g . dr awLine (p • x+d . width+2 , p . y+1 0 , GRIDLEFT , 

scale (updates [0] . listenerCount) ) ; 
if (updates [size - 1] != null) { 

g.drawString (String. valueOf (updates [size - 1] .listenerCount) , 
GRIDLEFT+size*INCR, 

scale (updates [size-1] .listenerCount) ) ; 

} 

} 



// draw graph of updates for this stock 
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int X ^BlDLEFT; 

for (in^^ = 0; i < size; i++) { 
if (updates [i] != null) { 

g.fillOval (x-1, scale (updates [i] . listenerCount) -1, 4, 4) ; 
if ((i < size - 1) && updates(i + 1) != null) { 

g.drawLine (x, scale (updates[i] . listenerCount ) , 

X + INCR, scale (updates (i + 1] . listenerCount )) ; 

} 

} 

X += INCR; 



/* 

* Used to scale y-values. 
V 

int scale (float y) { 

return HEIGHT - (int) (y*3+.5) - 50; 
//return HEIGHT - (int) (y*2+,5) - 50; 

} 

/* 

* Make sure that mouseHere is set properly, 
*/ 

void setMouseHere (boolean display) { 

Enumeration enum = channelTable • elements () ; 
while (enum.hasMoreElements 0 ) { 

ChannelData data = (ChannelData) enum, next Element () ; 

data. cb. mouseHere = display; 

} 

} 

} 

/ ★* 

* ChannelData contains stock updates and display information. 
*/ 

class ChannelData ( 



// channel 
public String id; 

private static int channelCount = 0; 

// update history 

public Vector updates; 

private static int updateCount; 

final static int MAX.UPDATES = 34; 



// display 

public boolean displayed; 
public SmartCheckbox cb; 
public Color color; 

private Color[] colorTable - (Color .black. Color. gray. Color. cyan. 

Color . pink. Color . magenta. Color . orange. 
Color .blue. brighter {) , Color. green, 
Color , red . brighter ( ) , Color . gray } ; 



* Constructor. 
*/ 

public ChannelData (String id) { 
this. id = id; 

this. color = colorTable [channelCount++ % colorTable. length] ; 
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this. updates = new V^^r (MAX_UP DATES ) ; 
displayed = true; 
} 

/* 

* Updates channel status. 
V 

void update (ChannelStatistics channel) { 
synchronized (updates) { 

if {updates. size 0 " MAX_UPDATES) { 
updates . removeElement At ( 0 ) ; 

} 

if (updates, size () < updateCount - 1) ( 

for (int i = updates . size () ; i < updateCount - 1; i++) { 
updates . addElement (channel) ; 

} 

} 

updates .addElement (channel) ; 
updateCount = updates . size () ; 

} 

} 

/ ★ * 

* Resets counters - 
*/ 

ppublic static void reset () { 
,fr, updateCount = 0; 
.~ channelCount = 0; 

01 
/* ^ 

* m smart checkbox that records whether the mouse is over the checkbox. 

claTs SmartCheckbox extends Canvas { 
l^ChannelData data; 
QDOolean state = true; 
fflChannelMonitorApplet panel; 
^boolean mouseHere = false; 

™public boolean haveMouseO ( 
~ return mouseHere; 

/ * * 

* Constructor. 
*/ 

public SmartCheckbox (ChannelData data, ChannelMonitorApplet p) ( 
this. data = data; 
panel = p; 

} 

public boolean mouseEnter (Event evt, int x, int y) ( 
if (state) { 

/ /panel. setMouseHere (false) ; 
mouseHere =» true; 
panel . repaint ( ) ; 

return false; 

} 



public boolean mouseExit (Event evt, int x, int y) { 
if (state) { 

mouseHere = false; 
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panel . repa^^^) ; 



return false; 

} 



public boolean mouseDown (Event evt, int x, int y) { 
if (state) 

state = false; 

else 

state = true; 
mouseHere = state; 
data. displayed = state; 
repaint ( ) ; 
panel . repaint ( ) ; 
return true; 

} 



public void paint (Graphics g) { 

g. setColor (Color .white) ; 

g.drawLine (4, 4,14,4); 

g.drawLine (4, 4, 4, 14) ; 

g. setColor (Color .gray) ; 

g.drawLine (5, 14, 14, 14) ; 

g.drawLine (14, 5, 14, 14) ; 

g. setColor (data. color) ; 
p g.fillRect (5, 5, 8, 8) ; 

. g . setColor (data . color) ; 

;2 g.drawString ("Ch-" + data. id, 17, 15); 

^ g. setColor (Color .white) ; 

^ if (state) { 

01 g.fillRect (7, 7, 4, 4); 

a } 

public void setState (boolean s) { 
L state = s; 

O repaint () ; 

SI } 

Q 
O 
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/* marconiNet - Internet Rad^«etwork 

* Distributed Radio Antenna^Krver (RAS) : [Channel Account.il^^ata] 
★ 

* $<marconi.ras.>ChannelStatistics. java -v2 . 0 (prototype version), 1999/05/22 $ 

* @jdkl.2, -riK. 
*/ 

package marconi . ras; 
/ ★ * 

* This class encapsulates the channel accounting information, such as the number 

* of current listeners. It can be extended to include other kinds of data for auditing 

* or periodic logging. 
* 

* Sauthor -riK. 

* 0 version $Revision: 1.0 $ 

* Gsee marconi • ras .Channel 

* Gsince prototype vl.O 
*/ 

public class ChannelStatistics implements java. io • Serializable { 



/** 

* Channel Id. 
*/ 

public String chan_id ~ 



'"r * Usage. The current number of listeners for the specified channel, 
y public int listenerCount =» 0; 

m * Constructor. 

S */ 

^public ChannelStatistics (String id, int count) { 

. chan_id = id; 
^ listenerCount = count; 
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la^Wrver (RAS) [Commercial Schedu^^ C 



/* marconiNet - Internet Rac 

* Distributed Radio Antenna'^^rver (RAS) : [Commercial Schedu^^ Class] 
* 

* $<marconi.ras,>CommercialSchedule. java -vl , 0 (prototype version), 1998/09/06 $ 

* @jdkl.l,7, -riK. 
*/ 

package marconi.ras; 

import java.io,*; 
import java^util . *; 



/ ★ * 

* The <code>CommercialSchedule</code> class represents a template for schedule of 

* commercial time slots. Currently, the number of commercial breaks each day and 

* the number of advertisement slots for each break are statically set, but it 

* should be extended to be more dynamic. In any event, it provides several APIs 

* for retrieving proper information from the advertisement database. 

* <p> 

* Qauthor -riK. 

* @version $Revision: 1.0 $ 

* @since prototype vl.O 
V 

public class CommercialSchedule { 

.ff An array of commercial breaks, 
private CommercialBreak [ ] breaks; 

gi/** 

ffl * Number of breaks per day. 

m */ 

public int N_BREAKS = 8; 

^* Break counter. 
01*/ 

^private int breakCounter = -1; 

yi 

Time-slot counter 
private int slotCounter = -1; 



y *★ 

* Creates new instance of commercial schedule. Use default number of breaks. 
V 

public CommercialSchedule <) { 

breaks = new CommercialBreak [N_BREAKS] ; 



// allocate breaks with slots 
for (int i = 0; i < N_BREAKS; i++) { 
breaks [i] = new CommercialBreak () ; 

} 



/** 

* Creates new instance of commercial schedule. This cannot be used in this 

* version because the advertisement registration protocol assumes the default 

* setting anyways. 
★ 

* Qparam freq number of breaks per day. 
*/ 
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#include <sys/socket . h> 
finclude <stdio.h> 
#include <netinet/in.h> 
#include <unistd.h> > 
finclude <string.h> 
#include <net/if-h> 
finclude <fcntl.h> 
#include <stropts.h> 
finclude <pthread.h> 
finclude <sched.h> 
finclude <stdlib.h> 
finclude <limits.h> 
finclude "RAS.h" 



• # 



extern uint32_t random32(int type) ; 

int total_threads = 0; 

int current_state_index = -1; 

State *state_array; 

int server_port, multicast_port ; 

int connfd; 



:naii(int argc, char **argv) 

{ m 

^t listenfd, fd; 
S|t ii n; 

l^£ruct sockaddr_in servaddr, cliaddr; 
ffit len sizeof (cliaddr) ; 
^questPkt *rp; 

^an buffer [sizeof (RequestPkt) + MAX_FILENAME] ; 
i^nt state_index; 

S (argc < 3) { 

printf ("usage: RAS <RAS port> <multicast port>\n"); 

exit(l); 

a 

ig:gv++; 

server_port = atoi(*argv); 



argv++; 

multicast_port = atoi(*argv); 

state_array = (State *) malloc (sizeof (State) * MAX_STATES) ; 
for (i=0; i<MAX_STATES; i++) { 
state_array[i] .valid » FALSE; 

} 

listenfd = socket (AF_INET, SOCK_STREAM, 0) ; 
if (listenfd < 0) { 

perror ("socket") ; 

exit(l); 

} 

bzero (fiservaddr, sizeof (servaddr)); 
servaddr. sin_faniily = AF_INET; 
servaddr. sin_addr.s_addr = htonl (INADDIUANY) ; 
servaddr .sin_port = server_j)ort; 

if (bind (listenfd, (struct sockaddr *) &servaddr, sizeof (servaddr)) < 0) { 



^ 5 32)9^13277 u 3 
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perror ("bind"); 
exit (1) ; 

} 

if (listen (listenfd, 1024) < 0) { 
perror ("listen") ; 
exit (1) ; 

} 

connfd = accept (listenfd, (struct sockaddr *) &cliaddr, ilen) ; 
if (connfd < 0) ( 

perror ("accept") ; 

exit (1) ; 

} 

rp = (RequestPkt *) buffer; 

while (TRUE) ( 

printf (" \n") ; 

if ((n = read (connfd, rp, MAX_REQUEST_LENGTH) ) <= 0) { 
perror ("read"); 

for(i - 0; i <= current_state_index; i++) ( 
if (state_array[i] • valid) { 
stop(i) ; 

} 

} 

exit (1) ; 

} 

// if (n == 0) continued- 
ford =0; i < 12; i++) { 
printf ("%x\n", buffer [i]); 

} 

printf ("RAS: main: rtL_addr=%x, lm_addr=%x\n", (uint32_t ) rp->n\_addr, 
(uint32_t) rp->lm_addr) ; 



state_index = f indLM<rp->lrtL_addr) ; 

switch (rp->request__type) { 

case PLAY: 

printf ("PLAY\n") ; 
sendStatus (play (state_index, rp->iTuaddr, rp->lnL.addr) ) ; 
break; 

case COMMERCIAL: 
printf ("COMM\n") ; 

printf ("state_index=%d, path_length«%d, path=%s\n", 
state_index, rp->path_length, rp->path) ; 

sendStatus (conunercial (state_index, rp->path_length, rp->path) ) ; 
break; 

case LOCAL_PLAY: 

printf ("LOCAL PLAY\n"); 

printf ("path_length«%d, path=%s\n", 
rp->path_length, rp->path) ; 
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sendStatus (localPlay (rp->lm_addr, rp->path_length, rp->path) ) ; 
break; 

case STOP: 

printf ("STOPXn") ; 

if (state_index < 0) sendStatus (ERROR); 
else stop (state_index) ; 
sendStatus (OK) ; 
break; 

default : 

printf CERROR\n") ; 
sendStatus (ERROR) ; 

} 

} 

} 

int f indNewIndex ( ) 
int i; 

print f ( " f indNewIndex ( ) : total_treads=%d, current_state_index=%d\n" , 
total_threads, current_state_index) ; 

ti (current_state_index == total_threads - 1) { 
J^if (current_state_index + 1 >= MAX_STATES) { 
4J printf ("findNewIndexl 0 : returning -1 \n"); 
^t" return -1; 

01} 

fflelse { 

printf ("findNewIndex2 0 : returning %d\n", current_state_index + 
return ++current_state_index; 

ip.se 

01 for (i=0; i<=current_state_index; i++) { 
IM: if ( !state_array[i] .valid) { 

In printf ("findNewIndex3 0 : returning %d\n'', i) ; 
:pt return i; 

y } 

printf ("f indNewIndex 0 : impossible! ! !\n"); 

} 



int findLM (uint32_t Inuaddr) 
{ 

int i; 

for ( i=0 ; i<=current_state_index; i++) { 

if (state_array[il .valid && state_array [i] . lm_addr Inuaddr) { 
printf ("findLMO : returning index %d\n", i) ; 
return i; 

} 

} 

printf ("findLMO : returning -l\n"); 
return -1; 



int conunercial (int state_index, int path_length, const char *path) { 
FILE *fd; 



printf ("commercial (state_index=%d, path_length=%d) \n". 
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state_index, ^^ftlength) ; 




if (state_index == -1 | | path_length <= 0) return ERROR; 

if {state_array (state_index] .fd) f close (state_array [state.index] .fd) ; 

fd - f open (path, "r") ; 
if (fd " NULL) { 

printf ("commerciaK ) : error opening file\n"); 

return ERROR; 

} 

state„array [state_index] .fd = fd; 

state_array [state_index] .request_type = COMMERCIAL; 
return OK; 

} 

int localPlay (uint32_t lni_addr, int path_length, const char *path) ( 
FILE *fd; 

int state_index, status; 

printf ("localPlay (path_length=%d, path=%s\n", 
path_length, path) ; 

if (path_length <= 0) return ERROR; 

p fd = fopen(path, "r"); 

if (fd == NULL) { 
l"^ printf ("localPlay 0 : error opening file\n"); 

return ERROR; 

^ } 

ffl 

W state_index = f indNewIndex () ; 

gi if (state_index == -1) return STATES_FULL; 



/* create new state entry */ 
= state_array [state_index] .fd = fd; 
5 state_array [state_index] .request_type = LOCAL_PLAY; 
W state_array (state_index] .nL_addr = NULL; 
1=^ state_array [state_index] .Inuaddr = lm_addr; 
\0 state_array[state_index] .valid = TRUE; 

Pi total_threads++; 

/* create a new playing thread (using old state entry) */ 
if ( (status = 

pthread_create (& (state_array [state_index] .tid) , 

NULL, processRequest, (void *) state_index) ) != 0) { 
printf ("play2: can't create thread: error # %d\n", status); 
exit(l); 

} 

return OK; 



void sendStatus (uint8_t status) 
( 

uint8_t s = status; 
write (connfd, &s, 1); 

} 



void *processRequest (void* index) 
struct ip_nireq mreq^jn, mreq^lm; 
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struct sockaddr_in sin__m, 
int 30c)c_m«-l/ sock_lm; 
int numread; 
rtp_paclcet *rp; 

char buffer [MAX_PAYLOAD_SIZE + FIXED_PKTLENGTH] ; 

char payload_buf [MAX_PAYLOAD_SIZE] ; 

FILE *fd; 

uintl6_t seq; 

uint32_t ssrc, ts; 

int lastPlaySeq=0, numAdSeq=*0; 

uint32_t state_index = (uint32_t) index; 
uint32_t m_addr = state_array [state_index] .m_addr; 
uint32_t lm_addr = state_array lstate_index] . lm_addr; 
int addr.len = sizeof (struct sockaddr_in) ; 

printf("in processRequest (index=%d) m_addr = %x, lm_addr = %x, multicast_port=%d\n", state_ 
index, m_addr, lm_addr, multicast_port) ; 

if (state_array [state_index] .request_type LOCAL_PLAY) { 
mreq_m.imr_multiaddr .s_addr = htonl(m_addr) ; 
mreq_m.imr_interface.s_addr htonl(INADDR_ANY) ; 

if((sock_m = socket (AF_INET, SOCK_DGRAM, 0)) < 0) { 
™ perror ("socket") ; 
y exit(l); 

m 

^af (setsockopt (sock_m, IPPROTO_IP, IP_ADD_^MBERSHIP, (char *)&mreq_m, ^ 
sizeof (Struct ip_mreq) ) < 0) { j 
Q perror ("setsockopt sock_m"); 
^ exit(l); 

^ sin„m.sin_addr .s_addr = htonl(m_addr) ; 
Dsin_m.sinuport = htons (multicast_port ) ; 
nisin_m.sin_family = AF_INET; 

t — '• 

5if (bind(sock_m, (struct sockaddr *)&sinjn, sizeof (sin_m) ) < 0) { 
□ perror ( "bind" ) ; 
Q exit(l); 

if (fcntl(sock_m, F_SETFL, 0_NDELAY) < 0) { 
perror ("fcntl") ; 
exit (1) ; 

} 



} 

mreq_lm.imr_multiaddr-s_addr = htonl (Inuaddr) ; 
mreq_lm.imr_interface.s_addr = htonl(INADDR^ANY) ; 

if((sock_lm = socket (AF.INET, SOCieOGRAM, 0) ) < 0) { 
perror ("socket") ; 
exit (1) ; 

) 

if (setsockopt (sock_lm, IPPROTO.IP, IP^D_MEMBERSHIP, (char *)&mreq_lm, 
sizeof (struct ipjareq) ) < 0) { 
perror ( " set sockopt sock_lm" ) ; 
exit (1) ; 

sin.lm.sin_addr.s_addr = htonl(lnuaddr) ; 
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sin_lm.sin_port = ht^^Bmult 
sin_lm.sin_fainily = A^^neT; 



sin_lm.sin_port = ht^^prnulticast_port ) ; ^Hf 



if (bind(sock_lm, (struct sockaddr *)&sin_lm, sizeof (sin_lra) ) < 0) { 
perror ("bind") ; 
exit (1) ; 

} 

/* we want the call to recv td be non-blocking */ 
if (fcntl (sock_lm, F_SETFL, 0_NDELAY) < 0) { 

perror ("fcntl") ; 

exit(l); 

} 

print f CprocessRequest (index=%d) : request_type=%d\n" , 

state_index, state_array [state_index] . request_type) ; 

while (TRUE) { 

switch (state_array [state_index] . request_type) { 
case PLAY: 



in 



/* check whether there is information on the socket */ 
numread = recv (sock_m, buffer, sizeof (buff er) , 0); 
if (numread>0) { 

rp = (rtp_packet *) buffer; 

if (abs (ntohl (rp->RTP_header,seq) - lastPlaySeq) >= numAdSeq-1) ( 
lastPlaySeq = ntohl (rp->RTP_header . seq) ; 
numAdSeq =0; 



if (sendto (sock_lra, buffer, numread, 0, (struct sockaddr *)&sin_lm, sizeof (str 
m- ct sockaddr_in) ) < 0) { 
gi perror ("sendto") ; 

exit(l); 

} 

^ } else { 

Q printf ("Ommiting an old packetXn"); 

m } 

N= } 

\g break; 



case COMMERCIAL: 

case LOCAL_PLAY: 

/* default action after we finish the commercial */; 

/* state_array [state_index] . request_type = PLAY; */ 



ssrc = random32(l); 
seq = 0; 
ts =» 0; 

fd = state_array [state^index] .fd; 



while (TRUE) { 

if (state_array [state_index] •request_type !=» COMMERCIAL && 

state_array [state_index] .request^type !- LOCAL_PLAY) 
break; 

numread = fread (payloadjDuf , 1, MAX_PAYLOAD_SIZE, f d) ; 
if (numread <= 0) { 

fseek(fd, 0, SEEI^SET) ; 

continue; 

} 

rp = (rtp_packet *) buffer; 
rp->RTP_header .version « RTP_VERSION; 
rp->RTP_header = 0; 
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rp->RTP_header,x = 
rp->RTP_header . cc = 
rp->RTP_header .pt ~ 0; 
rp->RTP_header . seq = htonl(seq); 
rp->RTP_header . ts « htonl(ts); 
rp->RTP_header . ssrc = htonl(ssrc) ; 
rp->payload_len = htonl (numread) ; 
memcpy (rp->payload, payload_buf, numread); 

if (sendto(soc)c_lm, buffer, FIXED_PKTLENGTH + numread, 0, (struct sockaddr *)&sin_lm, 
sizeof (struct sockaddr_in) ) < 0) { 
perror ("sendto") ; 
exit (1) ; 

} 

if (ts >= UINT_MAX - numread/ 8 I I seq >= USHRT_MAX - 1) { 
seq = 0; 
ts = 0; 

.} 

else { 

seq++; 

ts += numread/8; 

} 

numAdSeq++; 



usleep ((numread/8 - 10) * 1000); 
/* yield to another thread */ 
sched_yield() ; 

^ break; 

01 

default: /* either STOP or unknown request status */ 
m if (sock_m >= 0) 
r= close (sock_m) ; 

close (sock_lm) ; 
L state_array[state_index] .valid = FALSE; 

5 printf ("processRequest (index=%d) : request_type=%d. Returning NULL An", 
ffl state_index, state_array [state_index] .request_type) ; 

^ return NULL; 
f=|} /* switch */ 

^sched^ieldO ; 
} /* while (true) */ 



int play{int state.index, uint32_t nuaddr, uint32_t lm__addr) { 
int status; 

printf ("play (state_iindex=%d ...): total_treads=%d, current_state_index=%d\n", 
state_index, total_threads, current_state_index) ; 



/* If we already have an identical M-to-LM binding */ 
if (state_index !=» -1 && state_array [state_index] .m_addr == m^addr) { 
if (state_array [state_index] .request.type PLAY) { 

printf ("play(state_index=%d ..•): M-to-LM binding already existsXn", 

state.index) ; 
return (DUPLICATE); 

} 

if (state_array (state_index] .request.type == COMMERCIAL) { 

printf ("play (state_index=%d ..,): switching from commercial to play\n". 
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sta^^adex) ; 

state_array [state_index] .request_type « PLAY; 
return OK; 

} 

} 

/* If LM is already being used and M is different */ 
if (state_index != -1) { 

print f ("play (Stat e_index=%d ...): existing LM, new M\n", 
state_index) ; 

/* NOTE: need synchronization here */ 

state_array [state_index] .request_type = STOP; 

printf ("play () : waiting for thread to terminateXn" ) ; 

while(state_array(state_index] .valid) { /* wait for thread to terminate 
/* NOTE: can use condition variables here, or pthread_join () */ 
usleep(lOOO) ; 

} 

printf ("play 0 : thread has terminated. Proceeding. \n" ) ; 

/* modify the old thread's state entry */ 
state_array (state_index] .m_addr = m_addr; 
state_array [state_index] .request_type = PLAY; 
state_array [state_index] .valid = TRUE; 

/* create a new playing thread (using old state entry) */ 
if ( (status = 

pthread__create (& (state_array [state_index] . tid) , 

NULL, processRequest, (void *) state_index) ) != 0) 
printf ("playl: can't create thread: error # %d\n", status); 
exit (1) ; 

} 

return OK; 

} 

/* here, we have a new LM */ 

printf ("play (Stat e_index=%d) : new LM\n", state_index) ; 

/* NOTE: also synchronization needed below */ 
state_index = f indNewIndex () ; 

if (state_index == -1) return STATES_FULL; 

/* create new state entry */ 
state_array [state_index] .nL.addr = nuaddr; 
state_array [3tate_index] .lnL.addr = lnL_addr; 
state_array [state^index] .request_type = PLAY; 
state_array [3tate_index] .fd - NULL; 
state_array (state_index] .valid = TRUE; 

/* NOTE: synchronize here */ 
total_threads++; 

/* create a new playing thread (using old state entry) */ 
if ( (status = 

pthread_create (& (state_array (state_index] .tid) , 

NULL, processRequest, (void *) state_index) ) !- 0) ( 
printf ("play2: can't create thread: error # %d\n'', status); 
exit (1) ; 
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} 

return OK; 

} 



void stop(int state_index) { 

printf ("stop(state_iindex=%d) : total_treads=%d, current_state_index=%d\n 
state_index, total_threads, current_state_index) ; 

/* NOTE: synchronize */ 

state_array [state_index] ,request_type = STOP; 

printf ("stop{state_index=%d) : waiting for thread to terminate\n", 
state_index) ; 

while (state_array[state_index]- .valid) { /* wait for thread to terminate 
/* NOTE: can use condition variables here, or pthread_join () */ 
usleep (1000) ; 

printf ("stop(state_index=%d) : thread has terminated. Continuing ... \n", 
state_index) ; 

t<gal_threads — ; 

ifS (state_index == current_state_index) { 
i.|hile(state_index >= 0 && ! state_array [state_index — ] .valid) { 
^ current_state_index — ; 
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import java.io. 
import java.net.*; 
import java . lang . * ; 
import java.util.*; 

public class Marconi { 

private InputStream is; 
private OutputStream os; 
private Socket sock; 
private Hashtable h; 




public Marconi () { 

h = new Hashtable 0 ; 

} 

public static void main (String args[l) throws Exception { 
if (args. length != 3) { 

System. out .print In ("Marconi Server demo program: usage: " + 

"Marconi <RAS hostname> <RAS port> <RTP port>"); 
System. out. print In ("\nRun this program in place of Marconi " + 
"Server, to manually send requests to the Radio Antenna Server."); 
System. exit (1) ; 

) 



□ Marconi m = new Marconi (); 

xp II create a TCP socket for communication with the RAS 
J=! int rtcpPort = Integer .parseint (args [2] ) + 1; 

m.sock = new Socket (args [0] , Integer .parseint (args [1] )) ; 
5 m.is = m.sock.getlnputStreamO ; 
ffi m.os = m.sock.getOutputStreamO ; 



01 



char choice; 
String command; 
String [ ] commandArray ; 
byte [ ] requestPkt ; 

while (true) { 

PromptUser . display ( ) ; 



Q choice = PromptUser .get Input 0 ; 

switch (choice) { 
case ' 1' : // play 
// get M and LM 

commandArray » PromptUser .getPlayCommandO ; 

System.out .print ("Sending command: "); 

System. out . print In ("PLAY " + commandArray [ 0 ] + " " + 

commandArray ( 1 ] ) ; 
requestPkt - m.encodeRequest ( (byte) 1, commandArray [0] , 

commandArray ( 1 ] , null ) ; 



m.sendRequest (requestPkt) ; 

InsertAd iad = new InsertAd( commandArray, rtcpPort, m) ; 
m.h.put (commandArray [1] , iad) ; 
iad. start () ; 



break; 



case '2' : // stop 
// get LM 

command = PromptUser .get St opCommand () ; 
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SystemBB. print ( " Sending command : " ) ; 
System^^ut. print In ("STOP " + command); 
requestPkt m.encodeRequest ( (byte) 2, null, 

command, null) ; 

m . sendRequest ( requestPkt ) ; 

InsertAd th = (insertAd) m.h. get (command) ; 
if (th != null) { 
th.stopO ; 

m.h. remove (command) ; 

} 

break; 

case '3': //local play 

commandArray = PromptUser .getLocalPlayCommand ( ) ; 
System.out .print ("Sending command: "); 
System. out .print In ("LOCAL PLAY " + commandArray [0] + " 

commandArray [ 1 ] ) ; 

Schedule sch = new Schedule (commandArray, m) ; 

sch. start () ; 

break; 

case ' e' : 

System. out .println ("\n Try again. \n"); 
break; 

case ' q' : 
case 'Q' : 

m. sock. close () ; 

System. exit (0) ; 

default: 

System.out .println ("Invalid option. Try again."); 
} // switch 

} // while true 

} // main 



public synchronized void sendRequest (byte [] requestPkt) 
{ 

byte[] statusPkt = new byte[l]; 
int bytesRead; 

try { 

// send request to the RAS 

OS. write (requestPkt, 0, requestPkt .length) ; 

// read the status returned by the RAS 

if ((bytesRead = is.read(statusPkt) ) < 1) { 

System. err .println ("\nError: status not received. \n") ; 

else { 

System.out .println ("RAS returned status: " 

+ st at usMeaning (StatusPkt (0] )) ; 

} 

} catch (Exception e) ( 

System.out.println(e,getMessage() ) ; 

} 

} 
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public byte[] encodeRequ^l^int requestType, String m_add 

String lm_addr. String path) 

^ int m = 0, Im = 0, pathLength = (requestType == 3 t I requestType 
4) ? path. length () : 0; 

if {m_addr != null) m getlntegerIP (m_addr) ; 
if {lm_addr != null) Im = get Integer IP (lm_addr) ; 

// NOTE: we allocate 1 byte for path even if there's no path 
// (this conforms to the RequestPacket structure of the RAS) 
byte[] buffer = new byte[13 + ((requestType ==311 requestType 
==4) ? pathLength : 1)]; 




buffer [0] = (byte) ((requestType « 16) »> 24); 

buffer [1] = (byte) ((requestType « 24) »> 24); 

buffer [2] = (byte) ((pathLength « 16) »> 24); 

buffer[3] = (byte) ((pathLength « 24) »> 24); 



// request_type 



// path_length 



m 
m 
m 



m 



II 

if 



m 



(requestType ==1) { // play 



buffer [4] 
buffer [5] 
buffer [6] 
buffer [7] 

} 

else { 

buffer [4] 
buffer [5] 
buffer [6] 
buffer [7] 

\ 



(byte) 
(byte) 
(byte) 
(byte) 



(m >» 
((m « 
((m « 
( (m « 



24) ; 
8) »> 24); 
16) »> 24); 
24) »> 24); 



// 4 bytes of m 



// Ira 

buffer [8] = (byte) (Im »> 24); // 4 bytes of Im 

buffer[9] = (byte) (dm « 8) »> 24); 
buffer [10] = (byte) ( (Im « 16) »> 24); 
buffer [11] - (byte) (dm « 24) »> 24); 

if (requestType == 3 I I requestType == 4) ( // commercial 
byte[] bytePath = path.getBytes () ; 

for (int i = 0; i < bytePath. length; i++) { 
buffer[12 + i] = bytePath[i]; 

\ 

} 

else { // send a zero byte as the path if the path is empty 
buffer[12] - 0; 

} 



return buffer; 



private static int get Integer IP (String addr) { 

StringTokenizer st = new StringTokenizer (addr, "•"); 
int ip = 0; 



try { 

ip = 



Marconi, java 




Thu >rLii 17 14:13:41 1999 4 



6 * 256 + 



} 

catch (Exception e) { 

System,out,println("getIntegerIP 0 : error: " + e .getMessage () ) 

} 

return ip; 
} // getlntegerIP 

private static String statusMeaning (byte status) { 
switch (status) { 
case 0: return "OK"; 
case 1: return "ERROR"; 
case 2: return "DUPLICATE"; 
case 3: return "STATES_FULL"; 

default: return " (UNKNOWN_STATUS=" + status + ")"; 

} 
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import java.net. 
import java.util.*; 
import java.io.*; 

public class InsertAd extends Thread 
{ 

private String mAddress; 
private String mlAddress; 
private int mPort; 
private Marconi marconi; 
private InetAddress mGroup; 
private MulticastSocket ms; 
private Vector adList; 
private int lastSeq; 

public static final int pLength = 24; 

public InsertAd (String [] command, int p, Marconi m) { 
mAddress = command[0]; 
mlAddress = command [1]; 
mPort = p; 
marconi = m; 
lastSeq -1; 
adList = new Vector (); 

} 

private int decodeint (byte [] buffer, int start) { 
^ int result = 0; 

Ui 

kO result 1= ( (buffer [start+3] « 24) »> 24); 
g1 result 1= ( (buffer [start+2] « 24) »> 16); 
% result 1= ( (buffer [start+1] « 24) »> 8); 
result 1- (buffer [start] « 24); 



return result; 



? } 



n^ublic void run() { 

mGroup - InetAddress . get ByName (mAddress) ; 
^ ms = new MulticastSocket (mPort) ; 
Q ms . joinGroup (mGroup) ; 

o 

Buf feredReader br = 

new Buf feredReader (new FileReader (mAddress + ".1st")); 



String str; 

while {(str = br.readLineO ) null) { 
if (str.equals{"") ) continue; 
adList .addElement (str) ; 

} 



br .close 0 ; 



byte [] buffer « new byte [pLength] ; 
int current Ad =0; 
byte[l requestPkt; 

while (true) { 

DatagramPacket recv = new DatagramPacket (buffer, pLength) ; 
ms . receive (recv) ; 

int version = ((buffer[0] « 24) »> 30); 
int subtype ^ buffer [01 & 31; 
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int pt = (^^er[l] « 24) »> 24); 
short length = 0; 

length |= ((buffer [3] « 24) »> 24); 
length |= (buffer [2] « 8); 

int ssrc = decodeint (buffer, 4); 
int cSeq = decodeint (buff er, 12); 
int remaining - decodeint (buffer, 16); 
int cLength « decodeint (buffer, 20); 

/* System. out .print In ("Received packet:" + 

" version=" + version + 

" subtype^" + subtype + 

" pt=" + pt + 

" length=" + length + 

" ssrc=" + ssrc + 

" seq=" + cSeq + 

" remaining-" + remaining + 

" cLength=" + cLength) ; */ 

if (version != 2 1 | subtype != 1 II length != pLength/4 - 1 | 
pt != 204 II !(buffer[8] 'M' && buffer(9] == 'a' 
&& buffer (101 == ' r' && buffer [11] 'c')) 

{ 

System. out. println ("Received an invalid packet!"); 
continue; 

} 

if (cSeq ~ lastSeq) ( 

//System.out .println ("Received a retransmit packet!"); 
continue; 

} 

System.out .println ("Commercial starting in " + 

remaining + " seconds, lasting " + cLength + " seconds"); 

lastSeq = cSeq; 

Thread. sleep (remaining * 1000); 

requestPkt = marconi . encodeRequest ( (byte) 3, null, 

mlAddress, (String) adList .elementAt (currentAd) ) 
marconi . sendRecjuest (requestPkt) ; 

System.out .println ("Commercial " + 

(String) adList .elementAt (currentAd) + " Started ..•"); 
Thread. sleep (cLength * 1000); 

requestPkt « marconi .encodeRequest ( (byte) 1, mAddress, 

mlAddress, null) ; 
marconi. sendRequest (requestPkt) ; 

System.out .println (".• • Commercial " + 

(String) adList. element At (currentAd) + " Finished"); 
currentAd » (currentAd + 1) % adList.sizeO ; 

} 

} catch (Exception e) ( 

e . print StackTrace ( ) ; 

} 

} 

public void leave () ( 

try { ms.l€aveGroup(mGroup) ; ) 

catch (Exception e) ( e. print St ackTrace () ; } 
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} 

} 
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import java.net,*; 
import java.io.*; 
import java.util . *; 
import java. lang.Math. * ; 

public class IRC { 

* constants defining buffer sizes, etc. 
*/ 

public static final int payloadKBytes = 4; 

public static final int payloadBytes = payloadKBytes 

public static final int reset = 50; 

public static final int maxBuf f erEntries = 500; 



private BufferEntry be; 
private CircBuffer cb; 

private byte[] buffer; 
private boolean newSequence = true; 
private int startSeq; 
private int startTs; 
private long startTime; 
private long current_of f set ; 
private int currentSeq; 
P^private int ssrc; 

Spublic IRC 0 { 

Ul cb = new CircBuff er (maxBuff erEntries) ; 

f } 

^public boolean checkNewSequence (BufferEntry be) { 

4^ if (newSequence II Math . abs (be, seq - currentSeq) > 

t I I be. ssrc != ssrc) ( 

p System. out .println( "NEW SEQUENCE! ! ! ! ! ! ! ! I ! ! I ! ! ! 

;gi return true; 

else return false; 

^} 

O 

Q public void initVarsO { 
StartSeq = be.seq; 
StartTs = be.ts; 
ssrc = be, ssrc; 
Date d = new Date 0 ; 
StartTime « d, get Time (); 

current_offset - startTime - startTs + 512 * 20; 
if (newSequence) { 

currentSeq » startSeq; 

} 

newSequence = false; 

} 

private void decodePacket () ( 
int bO, bl, b2, b3; 

be = new Buf ferEntry () ; 

be.v « (buffer[0] « 24) »> 30; 




bO = (buffer[2] « 24) »> 24; 
bl = (buffer [3] « 24) »> 24; 
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be.seq = lt>0 <\ 



1 bl; 



bO 
bl 
b2 
b3 
bO 
bl 
b2 
b3 



buffer [4] ; 
buffer [5] ; 
buffer [6] ; 
buffer [7] ; 
(bO « 24) 
(bl « 24) 
(b2 « 24) 
(b3 « 24) 



»> 24 
»> 24 
»> 24 
»> 24 



be.ts = (bO « 24) | (bl « 16) I (b2 « 8) I b3; 



bO = buffer [8]; 

bl = buffer [9]; 

b2 = buffer [10] ; 

b3 - buffer [11] ; 

bO = (bO « 24) »> 24; 

bl = (bl « 24) »> 24; 

b2 (b2 « 24) »> 24; 

b3 = (b3 « 24) »> 24; 

be.ssrc = (bO « 24) I (bl « 16) 



I (b2 « 8) I b3; 



bO = buffer [16]; 
bl - buffer [17] ; 
b2 = buffer [18]; 
b3 = buffer [19]; 
bO = (bO « 24) »> 24; 
bl = (bl « 24) »> 24j 
b2 = (b2 « 24) »> 24; 
b3 = (b3 « 24) »> 24; 
be. length = (bO « 24) | (bl « 16) I (b2 « 8) I b3; 

be.payload = new byte [be.lengtli] ; 
for (int i = 20; i < be. length + 20; i++) { 
be.payload[i - 20] = buffer [i]; 

} 



} 



public static void main (String [ ] args) { 
try { 

IRC ire = new IRC ( ) ; 

if (args. length != 2) { 

System. out •println( "Usage : IRC <multicast addr> <port>''); 
return; 

} 

String mcastAddr - args[01; 

int port - Integer .parseint (args [1] ) ; 

// join a Multicast group 

InetAddress group - inetAddress.getByName (mcastAddr) ; 
MulticastSoclcet s = new MulticastSoc)cet (port) ; 
s . joinGroup (group) ; 

ire. buffer = new byte [payloadBytes + 20); 
irc.cb, start () ; 
while (true) { 

DatagramPacket recv = new DatagramPacket (ire. buffer, ire .buffer .length) ; 
s. receive (recv) ; 
ire . decodePaeket ( ) ; 
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3 



System. out .pr 




n(" received packet:" + 
" seq=" + irc.be. seq + 
" ts=" + irc.be.ts + 



" length=" + ire .be . length 
" ssrc='' + irc.be. ssrc) ; 



if (irc.checkNewSequence (ire .be) ) 
irc.initVars 0 ; 

irc.currentSeq = irc.be. seq; 

ire .be .of f set = ire.current_of f set; 

Date date = new DateO; 
long time = date .get Time () ; 

ire. cb. enqueue (ire.be) ; 



} // while true 

} 

catch (Exception e) { 

e.printStackTrace () ; 



// main 
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import java.io.*; 
import j ava • net . * ; 
import java.lang.*; 
import java.util. *; 

public class Marconi { 

private InputStream is; 
private OutputStream os; 
private Socket sock; 
private Hashtable h; 

public Marconi () { 

h = new Hashtable 0; 

} 

public static void main(String args(]) throws Exception { 
if (args, length != 3) { 

System. out .println ("Marconi Server demo program: usage: " + 

"Marconi <RAS hostname> <RAS port> <RTP port>"); 
System. out .println ("\nRun this program in place of Marconi " + 
"Server, to manually send requests to the Radio Antenna Server."); 
System. exit (1) ; 

} 
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™ Marconi m = new Marconi (); 

// create a TCP socket for communication with the RAS 
in int rtcpPort = Integer .parseint (args [2] ) + 1; 
ifl m.sock = new Socket (args [0] , Integer .parseint (args [1] )) ; 
gi m.is = m. sock. get InputStream 0 ; 
ffi m.os = m.sock.getOutputStreamO ; 

Hi char choice; 

^ String command; 

^ String!] commandArray; 

O byte[] requestPkt; 

m 

while (true) { 

PromptUser . display ( ) ; 

O choice = PromptUser .get Input 0 ; 

switch (choice) { 
case ' 1' : // play 
// get M and LM 

commandArray - PromptUser . getPlayCommand ( ) ; 

System . out . print ( " Sending command : " ) ; 

Systera.out .println("PLAY " + commandArray [ 0 ] + " " + 

commandArray [ 1 ] ) ; 
requestPkt - m.encodeRequest ( (byte) 1, commandArray [ 0 ] , 

commandArray [ 1 ] , null ) ; 



m.sendRequest (requestPkt) ; 

InsertAd iad « new insertAd (commandArray, rtcpPort, m) ; 
m.h.put (commandArray [1] , iad) ; 
iad ♦start 0 ; 



break; 



case '2' : // stop 
// get LM 

command = PromptUser.getStopCommandO ; 
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Sy sten^^ . print ( " Sending command : " ) ; 
System^lt. print In ("STOP " + command); 
requestPkt = ra.encodeRequest ( (byte) 2, null, 

command, null); 

m. sendRequest (requestPkt) ; 

InsertAd th = (insertAd) m.h, get (command) ; 
if (th != null) { 
th.stopO ; 

m . h . remove (command ) ; 

} 

break; 

case '3': //local play 

commandArray = PromptUser •getLocalPlayCoramandO ; 
System , out . print ( "Sending command : " ) ; 

System. out. println ("LOCAL PLAY " + commandArray [ 0 ] + " 

commandArray [ 1 ] ) ; 

Schedule sch = new Schedule (commandArray, m) ; 

sch. start () ; 

break; 

^ case 'e' : 

^ System. out .println ("\n Try again.Xn"); 

^ break; 

m 

case 'q' : 
ffl case ' Q' : 

fQ m. sock. close 0 ; 

^ System. exit (0) ; 

default: 

^ System. out .println("Invalid option. Try again."); 

O } // switch 



} // while true 
} // main 

public synchronized void sendRequest (byte [ ] requestPkt) 
( 

byte[] statusPkt - new byte[l]; 
int bytesRead; 

try { 

// send request to the RAS 

OS. write (requestPkt, 0, requestPkt .length) ; 

// read the status returned by the RAS 

if ((bytesRead = is. read (statusPkt ) ) < 1) { 

System.err .println ("\nError : status not received • \n") ; 

) 

else { 

System. out .println( "RAS returned status: " 

+ statusMeaning (StatusPkt [0] )) ; 

) 

} catch (Exception e) { 

System.out.println(e.getMessage() ) ; 

) 
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public byte[] encodeRequ nt requestType, String m_add 

m 

string Inuaddr, String path) 



^ int m = 0, Im = 0, pathLength = (requestType == 3 | | requestType 
==4) ? path, length 0 : 0; 

if {m_addr != null) m = getlntegerlP (m_addr) ; 
if {lm_addr != null) Im = get Integer IP (Inuaddr) ; 

// NOTE: we allocate 1 byte for path even if there's no path 
// (this conforms to the RequestPacket structure of the RAS) 
byte[] buffer = new byte (13 + ( (requestType == 3 II requestType 
4) ? pathLength ; 1)]; 



buffer [0] = (byte) ((requestType « 16) »> 24); 

buffer [1] = (byte) ((requestType « 24) »> 24); 

buffer [2] = (byte) ((pathLength « 16) »> 24); 

buffer [3] = (byte) ((pathLength « 24) »> 24); 



// request_type 



// path_length 



m 

m 



g 
m 



II m 

if (requestType ==1) { // play 



m 



buffer [4] 
buffer[5] 
buffer [6] 
buffer [7] 



else { 

buffer [4] 
buffer [5] 
bufferl6] 
buffer [7] 

} 



(byte) 
(byte) 
(byte) 
(byte) 



(m »> 24); // 4 bytes of ra 

( (ra « 8) »> 24) ; 

((m « 16) »> 24); 

( (m « 24) »> 24) ; 



// Im 

buffer [8] = (byte) (Im »> 24); // 4 bytes of Im 

buffer[9] = (byte) ( (Im « 8) »> 24); 
buffer [10] = (byte) (dm « 16) »> 24); 
buffer [11] = (byte) ( (Im « 24) »> 24); 

if (requestType 3 II requestType ==4) { // commercial 
byte[] bytePath = path.getBytes () ; 

for (int i = 0; i < bytePath* length; i++) { 
buffer[12 + i] = bytePath[i]; 

} 

else { // send a zero byte as the path if the path is empty 
buffer [12] - 0; 

} 



return buffer; 



private static int getlntegerIP (String addr) { 

StringTo)cenizer st = new StringToJcenizer (addr, "."); 
int ip = 0; 

try { 

ip = 
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+ 



* 256 + 



catch (Exception e) { 

Systera.out .println("getIntegerrP 0 : error: " + e .getMessage () ) ; 

} 

return ip; 
} // getlntegerIP 

private static String statusMeaning (byte status) { 
switch (status) { 
case 0: return "OK"; 
case 1: return "ERROR"; 
case 2: return "DUPLICATE"; 
case 3: return "STATES_FULL"; 

default: return " (UNKNOWN_STATUS=" + status + ")"; 
} 



Mi 
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import java . net . * ; 
import java. ut 11 . *; 
import java.io.*; 

public class RsSendRTCP extends Thread 
{ 

private String mAddress; 

private int mPort; 

private String scheduleFile; 

private int ssrc; 

private InetAddress mGroup; 

private MulticastSocket ms; 

private int cSeq; 

private Hashtable hTable; 

public static final byte version = 2; 

public static final int pLength = 24; 

public static final int retransmit = 3; 

public static final byte subtype = 1; 

public static final int maxHash = 7 * 86400; 

public RsSendRTCP (String addr, int p. String file) 
{ 

mAddress = addr; 

mPort = p; 
r=t scheduleFile = file; 

ssrc = (int) ( java. lang, Math. random () * 10000); 

cSeq = 0; 
yj hTable = new Hashtable (); 

m 

public void runO { 
m try { 

• %1 mGroup = InetAddress .get ByName (mAddress) ; 
+ . ms = new MulticastSocket (mPort) ; 
ms . joinGroup (mGroup) ; 



G 

g1 BufferedReader br = new Buff eredReader (new FileReader (scheduleFile) ) ; 

Li 



String str; 
i: int lineNum = 0; 

5 while ((str = br .readLine () ) != null) { 
O lineNum++; 

if (str. equals ("") ) continue; 

StringToJcenizer st - new StringTo)cenizer (str, " \t"); 
if (St .countTokens 0 != 5) { 

System. err. println ("Illegal number of parameters on line " 

+ lineNum + " of " + scheduleFile) ; 

continue; 

} 

int day = Integer .parseint (st .nextToken ()) ; 
int hour = Integer .parseint (st .nextToken ()) ; 
int minute = Integer .parseint (st .nextToken ()) ; 
int second » Integer .parseint (st .nextToken ()) ; 
int duration Integer .parseint (st .nextToken ()) ; 
day — ; 

int hash =• day * 86400 + hour * 3600 + minute * 60 + second; 

// System. out. print In ("Inserting " + day + " " + hour + " " + 

/ / minute + " " + second + " " + duration + " " + hash) ; 

hTable. put (new Integer (hash) , new Integer (duration) ) ; 
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/* MD5C.C - RSA Data Securi 
*/ 



t^^^nc./ MD5 message-digest algor^j^ 



/* Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991, All 
rights reserved. 

License to copy and use this software is granted provided that it 
is identified as the "RSA Data Security, Inc. MD5 Message-Digest 
Algorithm" in all material mentioning or referencing this software 
or this function. 

License is also granted to make and use derivative works provided 
that such works are identified as "derived from the RSA Data 
Security, Inc. MD5 Message-Digest Algorithm" in all material 
mentioning or referencing the derived work, 

RSA Data Security, Inc. makes no representations concerning either 
the merchantability of this software or the suitability of this 
software for any particular purpose. It is provided "as is" 
without express or implied warranty of any kind. 

These notices must be retained in any copies of any part of this 
documentation and/or software, 
V 

#ingj.ude "global. h" 
#iny.ude "md5,h" 
# include <memory.h> 

in 

st^c char rcsid[] = "$Id: md5c.c,v 1.1 1997/12/17 12:52:36 hgs Exp 
/* Ssnstants for MDSTransform routine. 

*l 

#de#ine Sll 7 
#d^ine 312 12 
#d^ne S13 17 
fd^iine SI 4 22 
fd^ine S21 5 
tdeline S22 9 
#d^ine S23 14 
td^ine S24 20 
fd^ine S31 4 
tdefine S32 11 
fdefine S33 16 
#define S34 23 
#defin€ 341 6 
#define S42 10 
fdefine S43 15 
#define S44 21 

static void MD5Transform PROTO_LIST ( (UINT4 [4], unsigned char [64])); 
static void Encode PROTO__J*IST 

({unsigned char *, UINT4 *, unsigned int)); 
static void Decode PROTO_LIST 

( (UINT4 *, unsigned char *, unsigned int)); 

static unsigned char PADDING [64] = { 

0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 

0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 

0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 

}; 



/* F, G, H and I are basic MD5 functions. 
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*/ 

♦define F(x, y, z) ( ( (x)~4 (y) ) | ((-x) 4 (z))) 

♦define G(x, y, z) ( ( (x) & (z)) | ( (y) 4 (-2))) 

♦define H(x, y, z) ( (x) (y) (z)) 

♦define I{x, y, z) ( (y) ^ ( (x) | (~z))) 

/* ROTATE_LEFT rotates x left n bits. 
*/ 

♦define ROTATE_LEFT(x, n) ( ( (x) « (n) ) I ( (x) » (32- (n)))) 

/* FF, GG, HH, and II transformations for rounds 1, 2, 3, and 4. 
Rotation is separate from addition to prevent recomputation. 
*/ 

♦define FF(a, b, c, d, x, s, ac) { \ 
(a) += F ((b), (c), (d)) + (X) + (UINT4)(ac); \ 
(a) = ROTATE_LEFT {(a), (s)); \ 
(a) += (b); \ 
} 

♦define GG(a, b, c, d, x, s, ac) { \ 
(a) += G ((b), (c), (d)) + (X) + (UINT4)(ac); \ 
(a) = ROTATE_LEFT ((a), (s)); \ 
(a) += (b); \ 
} 

♦define HH(a, b, c, d, x, s, ac) { \ 
^ (a) += H ((b), (c), (d)) + (X) + {UINT4)(ac); \ 
U (a) = ROTATE_LEFT ((a), (s)); \ 

=0 (a) +=■ (b); \ 

in ) 

,fi ♦define II (a, b, c, d, x, s, ac) { \ 

^ (a) +- I ((b), (c), (d)) + (X) + (UINT4) (ac); \ 

(a) = ROTATE_LEFT ((a), (s)); \ 
5 (a) += (b); \ 

yi } 

/* MD5 initialization. Begins an MD5 operation, writing a new context, 

n V 

~ void MDSInit (context) 

^ MD5_CTX *context; /* context */ 

{ 

context->count [0] - context->count [1] ~ 0; 
/* Load magic initialization constants. 

V 

context->state[0] = 0x67452301; 
context->state[l] = 0xefcdab89; 
context->state[2] = 0x98badcfe; 
context->state[3] = 0x10325476; 

} 

/* MD5 block update operation. Continues an MD5 message-digest 
operation, processing another message block, and updating the 
context . 
*/ 

void MDSUpdate (context, input, inputLen) 

MD5_CTX * context; /* context */ 

unsigned char * input; /* input block */ 

unsigned int inputLen; /* length of input block */ 

{ 

unsigned int i, index, partLen; 
/* Compute number of bytes mod 64 */ 

index « (unsigned int) ( (context->count [0] » 3) & 0x3F) ; 



1=^ 



/* Update number of bits */ 

if ( (context->count [0] += ( (UINT4) inputLen « 3)) < ( (UINT4) inputLen « 3)) 
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context->count [1] ++; 
context->count [1] += ( (UInWt input Len » 29); 

partLen = 64 - index; 

/* Transform as many times as possible. */ 
if (inputLen partLen) { 
memcpy 

( (POINTER) &context->buffer [index] , (POINTER) input, partLen) ; 
MDSTransform (context->state, context->buf f er) ; 

for (i = partLen; i 63 < inputLen; i += 64) 
MDSTransform (context->state, &input [i] ) ; 

index =0; 

} 

else 
i = 0; 

/* Buffer remaining input */ 
memcpy 

( (POINTER) &context->buffer [index] , (POINTER) &input [i] , 
inputLen-i) ; 

} 

/* a^S f inalization. Ends an MD5 message-digest operation, writing the 
tte message digest and zeroizing the context. 



voia. MDSFinal (digest, context) 

uns^ned char digest [16]; /* message digest */ 

MD^CTX *context; /* context */ 

{ ffl 

igEsigned char bits [8]; 
uj^signed int index, padLen; 

^ Save number of bits */ 

^code (bits, context->count , 8); 

m 

Pad out to 56 mod 64, */ 
^dex = (unsigned int) ( (context->count [0] » 3) & 0x3f ) ; 

§dLen = (index < 56) ? (56 - index) : (120 - index); 
SUpdate (context, PADDING, padLen); 

/* Append length (before padding) */ 
MDSUpdate (context, bits, 8); 

/* Store state in digest */ 

Encode (digest, context->state, 16); 

/* Zeroize sensitive information, */ 
memset ( (POINTER) context, 0, sizeof (^context) ) ; 
} /* MDSfinal */ 



/* MD5 basic transformation. Transforms state based on blocJc. 
V 

static void MDSTransform (state, block) 
aiNT4 state [4] ; 
unsigned char block [64]; 

^ UINT4 a = state [0], b = state [1], c = state [2], d = state [3], x[16]; 



Decode (x, block, 64); 



Ql 

m 
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I {c\ d, a! b! x[ 2], S43, Ox2acl7d2bb) ; /* 63 V 
I (b, c, d, a, x[ 9], S44, 0xeb86d391); /* 64 */ 



state [0] += a 

state [1] += b 
state [2] c 

state [3] += d 

/* Zeroize sensitive information, */ 
memset ( (POINTER) x, 0, sizeof (x) ) ; 



★ 



* Encodes input (UINT4) into output (unsigned char) . Assumes len 

* a multiple of 4. 
*/ 

static void Encode (output , input, len) 
unsigned char *output; 
UINT4 * input; 
uns^ned int len; 

{ >S 

u^igned int i, j; 

U\ 

^'r (i = 0, j = 0; j < len; i++, j += 4) { 
oiSiput[j] = (unsigned char) (input [i] & Oxf f ) ; 
oiB|put[j+l] = (unsigned char) ( (input [i] » 8) & Oxf f ) ; 
oi^ut[j+2] = (unsigned char) ( (input [i] » 16) i Oxf f ) ; 
oufeput[j+3] = (unsigned char) ( (input [i] » 24) & Oxf f ) ; 

r 

*|=©ecodes input (unsigned char) into output (UINT4) . Assumes len 
multiple of 4, 

*^ 

stteic void Decode (output, input, len) 
Ulltt4 *output; 
unsigned char * input; 
unsigned int len; 

{ 

unsigned int i, j; 

for (i = 0, j = 0; j < len; i++, j += 4) 
output [i] = ( (UINT4) input [j]) I (( (UINT4) input [j + 1] ) « 8) I 
(( (UINT4) input [j+2]) « 16) I (( (UINT4) input lj+3] ) « 24); 
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* Generate a random 32-bit qWKtity. 
V 

#include <sys/time,h> /* gettimeof day ( ) */ 

#include <unistd.h> /* get..() */ 

finclude <string.h> /* strncpyO */ 

tinclude <stdlib.h> /* atoiO */ 

finclude <stdio.h> /* printfO */ 

#include <sys/utsname .h> /* unameO */ 

#include <time.h> /* clockO */ 

tinclude "global. h" /* from RFC 1321 */ 

#include "mdS.h" /* from RFC 1321 */ 

extern long gethostid (void) ; 

static char rcsid[] = "$Id: random32.c,v 1,2 1998/09/29 16:31:37 hgs Exp 

fdefine MD_CTX MD5_CTX 
fdefine MDInit MDSInit 
fdefine MDUpdate MDSUpdate 
fdefine MDFinal MDSFinal 
typedef unsigned long u_int32; 

static u_int32 md_32(char *string, int length) 
{ 

Mg^CTX context; 
umon { 

^har c[16]; 
|ju_int32 x[4]; 
)^igest; 
u^nt32 r; 
i; 

l^lnit (ficontext) ; 

l#Update . (&context, (unsigned char *) string, length); 
WPFinal ((unsigned char *)&digest, icontext) ; 

XOR the four parts into one word */ 
f^r (i =0, r = 0; i < 3; i++) r ^» digest. x[i]; 
return r; 
} ft md_32 */ 

c 

Q 

/* 

* Return random unsigned 32-bit quantity, 
*/ 

uint32„t random32(int type) 
{ 

struct { 

int type; 

struct timeval tv; 

cloc)t_t cpu; 

pici_t pid; 

u_long hid; 

ui4_t uid; 

gidLt gid; 

struct utsname name; 
} s; 

gettimeofday (&s.tv, 0) ; 
s.type - type; 
s.cpu = clock 0 ; 
s.pid = getpidO 
s.hid = gethostidO; 



random32 . c 

s .uid = getuid ( ) ; 
s .gid = getgid ( ) ; 
uname ( & s . name ) ; 

return md_32 ( (char 
} /* randoms 2 */ 
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*)&s, sizeof(s)); 
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import java.io.*; 
import java.util .Date; 

/** 

* An audio output stream is an output stream for writing data to a 

* (possible dummy) audio device. 

* <p> 

* The stream records performance statistics, such as the milliseconds of 

* "dead air", * the number of writes that were late, etc. Statistics are 

* kept following the first write () invocation, 

* <P> 

* For accuracy, the class keeps statistics internally in microseconds, 

* but exports them in milliseconds. 

* <p> 

* On architectures supporting the "/dev/audio" device file (Solaris, Linux), 

* the AudioOutputStream will also write the data to the audio device, 
* 

* Gauthor Alexander V. Konstantinou 

* ^version $Revision: 1.5 $ 
V 

public class AudioOutputStream extends OutputStream { 
/** 

* microseconds per byte for 8 KHz, 8-bit MLAW samples 
V 

ji^Bfclic static final long mspb_8KHz_8bit_MLAW 125; 

pnvate long expiresMicros; 
p^i long microsPerByte; 
F^vate long missedMicros; 
fiSivate long lateWrites; 

I^vate FileOutputStream fostream = null; 



,* 

Create new AudioOutputStream with default encoding 8 KHz, B-bit MLAW 

W On architectures supporting a "/dev/audio" device file, the constructor 
S will attempt to open the device for writing (but will not fail if 
ti this is refused) . 

mjblic AudioOutputStream 0 { 
5super 0 ; 

□microsPerByte = mspb_8KH2_8bit_WLAW; 

// Try to open the /dev/audio device file 
try { 

fostream =» new FileOutputStream (" /dev/audio" ) ; 
} catch (Exception e) { 

System. err, println ("!!!!!! ! Can't open /dev/audio !!! Ill !!•"); 
fostream = null; 

} 

} 

/** 

* Create new AudioOutputStream for an unknown encoding which 

* expands a byte of data to "microsecondsPerByte" <B>micro</B>seconds 

* <P> 

* Note that the value is in <B>microseconds<B>, not milliseconds. 

* <P> 

* No attempt will be made to open the "/dev/audio" device file due 

* to the unknown format. 
V 

public AudioOutputStream (long microsecondsPerByte) { 
super ( ) ; 
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^^BecondsPerByte; 

^^nkown encoding is not written t^^u* 



microsPerByte = nii | 

f est ream = null; //^Jnkown encoding is not written t^^udio device 
} 

* Resets audio play statistics 
V 

public void resetStatsO { 
expiresMicros = 0; 
missedMicros = 0; 
lateWrites = 0; 

} 

/it* 

* Updates statistics for "count" bytes were buffered for audio output 
V 

private void logWriteBytes (int count) { 

long currentMicros - System. currentTimeMillis () * 1000; 
if (currentMicros > expiresMicros) { 
if (expiresMicros > 0) { 

missedMicros += currentMicros - expiresMicros; 
++lateWrites; 

} 

expiresMicros = currentMicros + count * microsPerByte; 
_ } else { 

M expiresMicros += count * microsPerByte; 

m } 
m ) 



* Writes the specified byte to the audio device, 
* 

ffl * Use of this method is discouraged, as the overhead for obtaining 
*C * the current time will be significant compared to the play time 

* for one byte. 
*/ 

public void write (int b) throws lOException { 
logWriteBytes (1) ; 

if (fostream != null) fostream. write (b) ; 

} 



* 

* Writes b. length bytes from the specified byte array to the audio 

* device. 
* 

* Avoid very small byte arrays for the same reason as write (int b) . 
*/ 

public void write (byte b[]) throws lOException ( 
logWriteBytes (b. length) ; 
if (fostream !- null) f ostream. write (b) ; 

} 

* 

* Writes len bytes from the specified byte array starting at offset o 

* to the audio device. 
* 

* Avoid very small lengths (len) for the same reason as write (int b) . 
*/ 

public void write (byte b(], int off, int len) throws lOException { 
logWriteBytes (len) ; 

if (fostream != null) f ostream. write (b) ; 

} 
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* Flushes this output str^^and forces any buffered outpul^^^es to 

* be written out. Curren^^ a no-op (does nothing). 
*/ 

public void flush () throws lOException { 
} 

/** 

* Closes this output stream and releases any system resources associated 

* with this stream, 

"I 

public void close () throws lOException { 
resetstats 0 ; 
if (fostream != null) { 

fostream. close () ; 

fostream = null; 

} 

} 

* Returns the number of milliseconds of "dead air" up to the last 

* write. 
* 

* Succesive invocations of this method without other intervening 

* AudioOutputStream method invocations will return the same value. 

% 

pilSlic long getMissedMillisAtLastWrite ( ) { 
tSeturn (missedMicros / 1000); 

m 

yj 

^Returns the number of milliseconds of "dead air" accumulated so far. 

Succesive invocations of this method may not return the same value if 
^ there is no buffered data for output, as this method returns the 
total so far (current time) . 

pablic long getMissedMillis () { 

;p.iong currentMicros = System. currentTimeMillis ( ) * 1000; 
^Mf (currentMicros > expiresMicros) { 

Q if (expiresMicros == 0) // special case - no writes so far 
Q return 0; 
else 

return ( (missedMicros + (currentMicros - expiresMicros)) / 1000); 

} else { 

return (missedMicros/1000) ; 

} 

} 

f -kit 

* Returns the number of late writes counted so far 
V 

public long getLateWriteGount () { 
return (lateWrites) ; 

} 

/** 

* Returns the expiration time in milliseconds of the current audio 

* playing. 
★ 

* If no audio is currently buffered, will return the time 

* when the last byte completed playing. 

* Time is represented as microseconds between the current time and 

* midnight, January 1, 1970 UTC. This measure is system dependent. 
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* with the current in milliseconds returned by 

* System. currentTime^Klis 0 
★ 

* @see Java.lang.SystemturrentTimeMillis 
V 

public long getBuf ferExpirationTime ( ) { 
return (expiresMicros / 1000); 

} 

/ * ★ 

* Returns the number of microseconds encoded in a byte, for the current 

* encoding. 
*/ 

public long getEncodingMicrosPerByte () { 
return (microsPerSyte) ; 

} 

/ ★* 

* Prints current statistics to System. out 
V 

public void printStatsO { 

long currentMicros = System. currentTimeMillis ( ) * 1000; 

System. out .println ("AudioOutputStream statistics at " + 

currentMicros / 1000 + " milliseconds"); 

tO if (expiresMicros > currentMicros) 

System. out .println (" Buffered milliseconds = " + 

(expiresMicros - currentMicros) / 1000); 

else 

ff^ System. out .println (" Buffered milliseconds = 0"); 

O System. out .println (" Missed milliseconds = " + getMissedMillis ( ) ) ; 

gi System. out .println (" Buffer will expire at = " + getBuf f erExpirationTime ()) ; 

^ System. out .println (" Late write count = " + getLateWriteCount () ) ; 

System, out .println ("") ; 

o ' ^ 

H * Demonstration and debuging code 

m */ 

Q public static void main (String [] args) { 

^ System. out .println ("AudioOutputStream Demonstration") ; 

^ System, out . println ( "===============:=================" ) ; 

System. out. print In ("") ; 

try { 

System, out .println ("Opening AudioOuputDevice for default encoding ..."); 
AudioOutputStream aos =■ new AudioOutputStreamO ; 
byte[] b - new byte [4096]; 

System.out .println ("Opening demo Sun AU format sound file ..."); 
File file - new File("spacemusic.au") ; 
FilelnputStreara fin » new FilelnputStreara (f ile) ; 

byted buffer = new byte [4 096]; 
int n « 0; 
do { 

System. out. println ("Reading 4K size buffer .,,"); 
n = fin. read (buffer, 0, 4096); 

System.out .println ("Writing buffer to AudioOutputStream ..."); 
if (n != -1) aos .write (buffer, 0, n) ; 
aos .printStats ( ) ; 

// Stress our test : create random delay 



\udioOutputStreain, java Thu^Jun 17 14:17:38 1999 5 

long sleepMillis = ^B^' * (aos .getBuf ferExpirati^Bime () - System, cur rent! imeMii 
lisO) * Math.randomO ) ; 

if (sleepMillis > 0) { 

System.out.println ("Sleeping for " + sleepMillis + " ..•"); 

Thread, sleep (sleepMillis) ; 

} 

} while (n != -1); 

aos.printStats () ; 
aos.close 0 ; 
} catch (Exception e) { 
e . pr intStackTrace ( ) ; 

} 

} 



} // class AudioOutputStream 
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import java.awt.*; 
import java.io.*; 

public class TextEdit extends Frame { 

public TextEdit (String [] commandArray, Marconi m) 
this.m - m; 

this. commandArray » commandArray; 

setTitle( "TextEdit") ; 

Panel pi = new Panel (); 

pi . setLayout (new FlowLayout ( ) ) ; 

pi. add (new Label { "filename : ")); 

filename = new Text Field (commandArray [1] , 20); 

pi .add (filename) ; 

add ("Center", pi); 

Panel p2 = new Panel (); 

p2. setLayout (new FlowLayout ()) ; 

p2.add(createButton =» new Button ("Create")); 

p2,add(finishButton = new Button ("Finish")); 

add ("South", p2); 

} 



public boolean handleEvent (Event event) { 

if (event. id == Event .ACTION_EVENT && event-target == createButton) 
String fname = filename .get Text () ; 
O if (fname.equals ("") ) return true; 
/* tO boolean flag = false; 
:'m try { 

Buf f eredReader br = new Buff eredReader (new FileReader (fname) ) ; 

S > 

catch (FileNotFoundException e) { 
ffl flag = true; 

ffl } 

£ if (!flag) { 

System. out .println ("file "+fname+" already exists"); 
return true; 

Frame ne = new NewEdit (fname, this); 
H ne. resize (200, 150); 
S this. hide 0 ; 
Q ne • show ( ) ; 
f=^ return true; 
^} 

if (event, id Event .ACTION_EVENT event. target f inishButton) 
dispose 0 ; 

m. sendSchedule (commandArray, Thread, cur rent Thread () ) ; 
Thread, current Thread 0 . suspend () ; 
return true; 

} 

return super .handleEvent (event) ; 

} 

/* 

public static void main (String [] args) { 
String [] str = new String []; 
Frame f = new TextEdit (str) ; 
f .setSizeOOO, 150); 
f . show ( ) ; 

} 

V 

private TextField filename; 

private Button createButton, f inishButton; 

private String [] commandArray; 
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private Marconi m; 
} 
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import java.io.*; 
import java.util.* 
import java.lang.* 
import java. text . * 
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public class Schedule extends Thread { 



private String ImAddress; 

private Marconi marconi; 

public static String scheduleFile; 

public static int[] dateArray = new int[4]; 

public Schedule (String [] command, Marconi m) { 
ImAddress = command[0]; 
scheduleFile = command [1]; 
marconi = m; 

} 



public void run{) { 
try { 

byte [ ] requestPkt ; 
boolean flag; 

while (true) { 

BufferedReader br = new Buf feredReader (new FileReader (scheduleFile) ) ; 

int[] array = new int[8]; 

String str; 
"^d while ((str = br • readLine {) ) != null) { 
.i" int index = 0; 

5: StringTokenizer st = new StringTokenizer (str, " "); 

for (int i=0; i<8; i++) { 
01 /* int endlndex = str . indexOf (' index); 

^ array(i] = Integer.parselnt (str,substring(index, endlndex)); 

index = endIndex+1; */ 
~ array (i] = Integer .par seint (st .nextToken ()) ; 

y } 

//:f'' string fileName = str .substring (index) ; 

¥^ String fileName = st .nextToken ( ) ; 

C- getCurrentDate ( ) ; 

^ if (isBetween (array) ) { 
^ // start playing 

if (isAddress (fileName) ) flag = false; 

else flag true; 

System, out .println{ "fileName: "+f ileName) ; 
if (flag) 

requestPkt - marconi .encodeRequest ( (byte) 4, null, ImAddress, fileName) ; 
else 

requestPkt » marconi. encodeRequest ( (byte) 1, fileName, ImAddress, null); 



marconi . sendRequest (requestPkt) ; 

/* System. out .println ("now in date range:"); 

for (int i=0; i<8; i++) { 

Sy stem. out. print (array [i] + " "); 

} 

Sy stem. out. print In () ; 
if (flag) 

System.out .println ("Playing file "+f ileName) ; 
else 

System, out. print In ("Redirecting packets from "+fileName); */ 
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while (true) { ( 

Thread. sleep^WOO) ; 

getCurrentDate ( ) ; 

if ( i isBetween (array) ) break; 

} 

// stop playing 

requestPkt = marconi .encodeRequest ( (byte) 2, null, ImAddress, null) ; 
marconi .sendRequest (requestPkt) ; 
} // if 

} 

} //while 

} 

catch (Exception e) { 
e.printStackTrace 0 ; 

} 

} 

public boolean isAddress (String str) { 
int count=0; 
int index=0; 

while ( (index=str. indexOf (' . ' , index)) != -1) { 
count++; 
index++; 

} 

if (count == 3) return true; 
Q else return false; 

public static void main(String args[]) throws Exception { 

'"^ try { 



m 



if (args, length != 1) { 

System.out.println ("Usage : Schedule <schedule data file>"); 
Wi return; 

■i > 

String scheduleFile ~ args[0]; 
while (true) { 

Buf feredReader br = new Buff eredReader (new FileReader (scheduleFile) ) ; 

M int[] array = new int [8]; 

iO String str; 

p while ((str = br .readLine () ) != null) { 

,~ int index =0; 

^ for (int i=0; i<8; i++) { 

int endlndex ~ str .indexOf (' index); 

array [i] = Integer .parselnt (str . substring (index, endlndex)); 
index = endIndex+1; 

} 

String fileNarae » str . substring (index) ; 
String localName « "LOCAL"; 
getCurrentDate () ; 

if (isBetween (array) ) ( 
// PLAY 

System.out.println ("current time:"); 
for (int i=0; i<4; i++) { 

System.out .print (dateArray[i] + " "); 

} 

System.out.println 0 ; 
System.out.println ("date range:"); 
for (int 1=0; i<8; i++) { 

System.out .print (array [i] + " "); 

} 

System. out .printlnO ; 

System.out.println("Playing file "+f ileName) ; 
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while (true) { 

Thread, sleep (1000)^ 
getCurrentDate () ; 
if ( ! isBetween (array) ) break; 

} 

// STOP PLAYING 
} // if 
} 

} //while 
} 

catch (Exception e) { 
e.printStackTrace 0 ; 

} 

} // main 

public static void getCurrentDate ( ) { 
Date myDate = new DateO; 

Calendar myCalendar = Calendar .getlnstance () ; 
dateArray [ 0 ] = myCalendar . get (Calendar . DAY_OF_WEEK) -1 ; 
dateArray[l] = myCalendar .get (Calendar .HOUR_OF_DAy) ; 
dateArray [2] = myCalendar .get (Calendar .MINUTE) ; 
dateArray [ 3 ] = myCalendar . get (Calendar . SECOND) ; 

} 

public static boolean isBetween (int [] array) { 

(int i=array[0]; ;i=(i+l)%7) { 
iJlif (i == dateArray [0] ) { 
)Q if (i != array [0] i != array [4]) 
;J return true; //between 2 days 

ffl if (i == array (0]) ( //sometime on the left boundary day 
if (dateArray [1] < array [1]) // if hour is earlier 
return false; 

£ if (dateArray [1] == array[l]) { // figure out the minutes 

Q if (dateArray [2] < array [2]) return false; 

™ if (dateArray [2] array [2]) ( // figure out the seconds 

if (dateArray [3] < array[31) return false; 
^ if (dateArray [3] == array [3] II array[0] !«array[4]) 

return true; 

a } 

O else if (dateArray [0] != array [4]) return true; 

} 

else if (dateArray [0] != array [4]) return true; 

if (i == array [4]) ( //sometime on the right boundary day 
if (dateArray [1] > array[5]) // if time is later 
return false; 

else if (dateArray [1] < array [5]) //has already been checked for early 

return true; 
else ( // hours are equal 

if (dateArray(2] < array [6]) return true; 

if (dateArray [2] > array [6]) return false; 

//minutes are equal 

if (dateArray [3] > array [7]) return false; 
return true; 

} 

} 

break; 

} 

if (i array [4]) break; 

} 

return false; 

} 
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} // class 
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import j ava . awt . * ; 
import java.io.*; 

public class NewEdit extends Frame { 

public NewEdit (String fileName, Frame f) { 
this.f = f; 
try { 

bw = new Buff eredWriter (new FileWriter (f ileName) ) ; 

} 

catch (lOException e) { 
System. exit (0) ; 

} 

this. filename = f ileName; 

setTitle ("NewEdit") ; 

Panel pi = new Panel (); 

pi . setLayout (new FlowLayout ( ) ) ; 

newButton = new Button ("New Entry"); 

pi . add (newButton) ; 

finishButton = new Button ("Finish"); 
pi .add(finishButton) ; 
add ("Center", pi); 



public void processEdit (Edit Info info) ( 
^String space = " "; 
"iry { 

bw.write (info.fromDay, 0, 1) ; 
Lj bw. write (space, 0, 1); 

S bw. write (info. f romHour, 0, inf o.fromHour. length () ) ; 
01 bw. write (space, 0, 1); 

pi bw.write (info.f romMin, 0, info. fromMin. length ()) ; 
'rf, bw.write (space, 0, 1); 

% bw.write (info.f romSec, 0, info. fromSec. length ()) ; 

bw.write (space, 0, 1); 

bw.write ( inf o.toDay, 0, 1); 
p bw.write (space, 0, 1); 

bw.write (inf o.toHour, 0, info, toHour. length ()) ; 
y, bw.write (space, 0, 1); 

If^ bw.write (info. toMin, 0, info.toMin. length {)) ; 
^ bw.write (space, 0, 1); 

y bw.write (info. toSec, 0, info.toSec.lengthO ) ; 
bw.write (space, 0, 1); 

bw.write (inf o. filename, 0, info.f ilename. length () ) ; 
bw.newLine 0 ; 

} 

catch (lOException e) { 
System.exit (0) ; 

} 

} 

public boolean handleEvent (Event event) { 

if (event. id == Event .ACTION_EVENT event. target == newButton) { 
Editlnfo in = new EditlnfoO; 
EditDialog ed =» new EditDialog (this, in); 
ed.showO ; 

else if (event. id Event .ACT ION_EVENT && event. target finishButton) 
try { 

bw. close 0 ; 

} 

catch (lOException e) { 
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} 

dispose 0 ; 
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f .showO ; 

} 

return true; 

} 

private Button newButton, f inishButton; 
private String fileName; 
private Buf f eredWriter bw; 
private Frame f ; 

) 

class Editlnfo { 

String fromDay, toDay, fromHour, toHour, fromMin, toMin, fromSec, 
toSec, filename; 

Editlnfo (String fromDay, String toDay, String fromHour, String toHour, 
String fromMin, String toMin, String fromSec, String toSec, 
String filename) { 
this.fromDay = fromDay; 
this.toDay = toDay; 
this . f romHour = fromHour; 
this.toHour = toHour; 
this. fromMin = fromMin; 
this.toMin = toMin; 
this.fromSec = fromSec; 
Q this.toSec = toSec; 

J this. filename = filename; 

I > 

^ Editlnfo 0 {} 

^ } 

m 

■rQ class Days { 
■ff. List days; 
DaysO { 

''^ days = new Listd, false); 

^ days.addItem("0:Sun") ; 

0 days . addltem ( " 1 : Mon" ) ; 

01 days . addltem ( " 2 : Tue " ) ; 
U days. addltem ("3: Wed" ) ; 
Ifz days.addItem("4:Thu") ; 
^ days . addltem ( " 5 : Fr i " ) ; 

days • addltem ( " 6 : Sat " ) ; 
days. select (0) ; 

} 

} 

class EditDialog extends Dialog { 

public EditDialog (NewEdit parent, Editlnfo u) { 
super (parent, "Edit Entry", true); 
fromDay » new DaysO; 
toDay » new DaysO; 
Panel pi » new Panel () ; 
pl.setLayout (new GridLayout (9, 2) ) ; 
pi. add (new Label ("From day:")); 
pi . add ( fromDay . days ) ; 
pi. add (new Label ("From hour:")); 
pi. add (fromHour = new TextField (2) ) ; 
pi. add (new Label ("From minute:")); 
pi. add (fromMin « new TextField (2) ) ; 
pi .add (new Label ("From second:")); 
pi. add (fromSec - new TextField (2) ) ; 
pi. add (new Label ("To day:")); 
pi .add(toDay .days) ; 
pi. add (new Label ("To hour:")); 
pl.add(toHour = new TextField (2) ) ; 
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pi. add (new Label ("To mir 
pl.add(toMin = new TextF^Wd (2) ) 
pi. add (new Label ("To second:")); 
pl.add(toSec = new TextField(2) ) ; 
pi . add (new Label ( "File/Channel : " ) ) ; 
pi. add (filename = new TextField("", 20)); 
CheckboxGroup g = new CheckboxGroup ( ) ; 
Panel p3 = new Panel (); 
p3, set Layout (new FlowLayout () ) ; 

p3.add(localBox = new Checkbox ("Local", q, true)); 
p3.add(globalBox new Checkbox ("Global", g, false)); 
add ("Center", p3) ; 
add ("North", pi); 
Panel p2 = new Panel 0; 
p2,add(okButton = new Button ("Ok") ) ; 
p2.add(cancelButton = new Button ("Cancel") ) ; 
add ("South", p2) ; 
resize (200, 400); 

} 

public boolean action (Event event. Object arg) { 
if (arg. equals ("Ok") ) { 

if (fromHour.getText 0 .equals ("") II t oHour. get Text () .equals ("") 
II fromMin.getText 0 .equals ("") II toMin.getText () .equals ("") II 
_ fromSec.getText 0 .equals ("") II toSec.getText () .equals ("") 
O I I filename.getText 0 .equals ("")) 

return true; 
yi try { 

if (Integer .parseint (fromHour.getText 0 ) < 0 II 
m Integer .parseint (fromHour.getText 0 ) > 23 I I 

Integer .parseint (toHour.get Text 0 ) < 0 II 
Integer .parseint (toHour, get Text 0 ) > 23 I I 
^ Integer. parseint (fromMin.getText 0 ) < 0 || 

+= Integer. parseint (fromMin. get Text () ) > 59 I I 

g Integer. parseint (toMin.getText () ) < 0 M 

Q Integer. parseint (toMin.getText 0 ) > 59 I I 

fn Integer. parseint (fromSec.getText 0 ) < 0 II 

Integer .parseint (froraSec. getText () ) > 59 I I 
Int eger. parseint (toSec, getText 0 ) < 0 II 
Integer. parseint (toSec.getText 0 ) > 59) 
O return true; 

catch (NumberFormatException e) { 
return true; 

} 

String fnarae = new String (); 
String str; 
boolean flag false; 
if (globalBox.getStateO ) { 
try { 

BufferedReader b. = new Buf feredReader (new FileReader ("^apsta") ) ; 
while ((str - b.readLineO) !» null) ( 
int index «■ 0; 

int endlndex = str . indexOf {' index); 

String addr =» str .substring (index, endlndex); 

System. out .println ( "str : "+str . substring (endIndex+1 ) ) ; 

if ( (str. substring (endIndex+1) ) .compareTo (filename.getText () )==0) 

fname = addr; 

flag = true; 

break; 

} 

} 

b. close 0 ; 

} 



m 
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catch (lOExcep^^ e) {} 



if ('flag) { 

System. out .println( "Channel name "+f ilename . getText ( ) +" not found"); 
return true; 

} 

} 

else fname = filename. getText () ; 
dispose 0 ; 

Editlnfo result = new Editlnfo ( fromDay. days. get SelectedltemO , toDay. days. get Selected 

f temO , 

fromHour .getText () , toHour .getText 0 , f romMin . getText () , 
toMin.getText () , fromSec. getText 0 , toSec. get Text () , fname) ; 
( (NewEdit)getParent () ) .processEdit (result) ; 

} 

else if (arg. equals ("Cancel") ) { 
dispose 0 ; 

} 

else return super . action (event , arg) ; 
return true; 

} 

public boolean handleEvent (Event evt) { 

if (evt. id == Event .WINDOW_DESTROy) disposeO; 
Q else return super .handleEvent (evt) ; 

tp return true; 

m > 

^ private TextField fromHour, toHour, fromMin, toMin, fromSec, toSec, filename; r 

private Button okButton, cancelButton; 

CO private Days fromDay, toDay; 

ffl private Checkbox localBox, globalBox; 
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la^Krver (RAS) : [IRC Action Handl^^ 



/* marconiNet - Internet Rac 

* Distributed Radio Antenna^^rver (RAS) : [IRC Action Handle 
* 

* $<marconi.irc.>IRCActionHandler. java -v2 . 0 (prototype version), 1999/04/21 

* @jdkl.2, -riK. 
*/ 

package marconi.irc; 

import java.awt,*; 

import j ava . awt . event . * ; 

import java.util,*; 

import java.io.*; 

/** 

* This class handles actions taken by IRC user, 
*/ 

public class IRCActionHandler { 

public static ActionListener listControl = new ActionListener () { 
public void actionPerformed(ActionEvent e) { 
IRCControls • entry_l . setText 

( IRCDirectory . direct oryList_l • get Item 
(lRCDirectory.directoryList_l.getSelectedIndex() ) ) ; 
String textfield = IRCControls .entry_l .getText () ; 
StringTokenizer dir = new StringTokenizer (textfield, " "); 
int id = Integer .parseint (dir. nextToken 0 ) ; 
O if (IRCDirectory, owner. playChannel (id) ) { 

tO System. out .print In ( "marconi . ire . IRCActionHandler" + 

ip " .actionPerformed: playing channel " 

HI + id + "."); 

:= } 

else ( 

uj IRCDirectory. owner. stopChannel () ; 

ffl System . err . print In ( "marconi . ire . IRCActionHandler" + 

J ".actionPerformed: error listening."); 

\ 
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/* marconiNet - Internet Rac^^ietwork 

* Distributed Radio Antenn^Rrver (RAS) : [IRC GUI Controls! 
* 

* $<marconi.irc.>IRCControls. java -v2 . 0 (prototype version), 1999/02/15 $ 

* 0jdkl.2, -riK. 
*/ 

package marconi. ire- 
import j ava . awt . * ; 
import java.awt •event .*; 
import java.util. *; 
import java.net.*; 
import java.io.*; 

/ * * 

* This panel contains user interfaces to the applet. 
*/ 

public class IRCControls extends Panel { 
public static TextField entry_l; 
private static int WIDTH = 600; 
private static int HEIGHT = 100; 

/** 

* Instantiates the control panel. 

□ V 

public IRCControls () { 

GridBagLayout grid = new GridBagLayout ( ) ; 
GridBagConstraints cons = new GridBagConstraints ( ) ; 
setLayout (grid) ; 

cons, fill === GridBagConstraints. NONE; 
cons.weightx = 0.0; 



01 

■PI 



// selected station (id + name) 

entry.l = new TextField(40) ; 

grid.setConstraints (entry_l, cons) ; 

entry_l .set Foreground (Color. yellow. darker 0 ) ; 

ent ry_l.setBackground (Color. blue. darker 0 .darker () ) ; 

add(entry_l) ; 

validate 0 ; 

// resize 

setSize (WIDTH, HEIGHT) ; 
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/* marconiNet - Internet Radi^^twork 

* Distributed Radio Antenna ^^ver (RAS) : [IRC Directory Con^^sj 



ir 

* $<marconi.ras.>IRCDirectory. java -v2 . 0 (prototype version), 1999/04/20 $ 

* 0jdkl.2, -riK, 
*/ 

package marconi . ire- 
import java . awt . * ; 
import java.awt .event 
import java.util.Hashtable; 
import java.net. *; 
import java.io.*; 

import marconi , ras . MarconiServer ; 
import marconi. util.CDPPacket; 

/** 

* This panel contains user interfaces to the applet. 
V 

public class IRCDirectory extends Panel 
implements Runnable { 

* This thread updates the announcements for the locally supported channels. 

-.*/ 

private Thread updateThread = null; 

\yrivate static long L_UPDATE = 7500; 

m 

public static IRCUsrApplet owner; 
;^ublic static Label label_l; 
:^ublic static List direct oryList_l ; 
Srivate static int WIDTH = 600; 
private static int HEIGHT = 400; 

£ /** 

n * Instantiates the directory display panel- 

republic IRCDirectory (IRCUsrApplet mam) { 
^ owner = main; 

GridBagLayout grid = new GridBagLayout ( ) ; 
GridBagConstraints cons = new GridBagConstraints () ; 
setLayout (grid) ; 

cons. fill = GridBagConstraints. NONE; 
cons.weightx =1.0; 

// label 1 
cons.weightx « 1.0; 

cons.gridwidth - GridBagConstraints .REMAINDER; 
label_l = new Label () ; 

label_l.setText ("Local Channel Directory"); 
grid.setConstraints (labeU, cons) ; 
label_l . setForeground (Color . white) ; 
add(label_l) ; 
validate 0 ; 

// list 1 - global 

cons.gridwidth = GridBagConstraints .REMAINDER; 
directoryList^l = new List (20, false); 

directoryList_l.addActionListener (IRCActionHandler.listControl) ; 

grid.setConstraints (directoryList_l, cons) ; 
directoryList_l.setForeground (Color .yellow. brighter () ) ; 

directoryList.l . setBackground (Color . darkGray ) ; 

add(directoryList_l) ; 

validate {); 
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// resize 
setSize (WIDTH, HEIGHT); 
start 0 ; 

} 

/ * * 

* Starts the directory update. 
*/ 

public void start () { 

updateThread = new Thread (this) ; 
updateThread. start () ; 

} 

/ * * 

* The run methods for the two threads, 
public void run() { 

// local directory 

while (Thread. currentThreadO == updateThread) { 
try ( 

Thread. sleep (L_UPDATE) ; 
™ Hashtable cdp_lookup = owner .getCache () ; 

U 

I^B if (direct oryList_l .get ItemCount 0 > 0) { 

U] directoryList_l . removeAll ( ) ; 

;01 for (int i = 0; i < owner .MAX_CHANNELS; i++) { ^ 

ffi String Id = String .valueOf (i) ; ' 

^ if (cdp_lookup,containsKey (Id) ) { 

Hi CDPPacket cdp = (CDPPacket) cdp_lookup.get (Id) ; 

+= directoryList_l .add(cdp.id + " " + cdp, name, 

5 Integer .parseint (cdp. id) ) ; 

\m else { 

^ directoryList_l .add(Id) ; 

} 

~ } 

W if (cdp_lookup.containsKey (MarconiServer .LOCALSTA) ) { 

y CDPPacket cdp = (CDPPacket) cdp_lookup. get (Marconi Server .LOCALSTA) ; 

directoryList„l .add (cdp. name) ; 

} 

} 

catch (Exception e) { 

System. err .print In ("marconi . ire, IRCDirectory .run: ") ; 
e .printStackTrace ( ) ; 

} 

} 
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c^^»etwork 

a^Trver (RAS) : (IRC User Applet 



/* marconiNet - Internet Ra^ 

* Distributed Radio Antenna'' 
* 

* $<marconi.irc.>IRCUsrApplet . java -v2 . 0 (prototype version), 1999/04/20 $ 

* 0jdkl.2, -riK. 
*/ 

package marconi , ire- 
import java . applet . * ; 
import java.awt.*; 
import java.util.*; 
import java.net.*; 
/ /import j ava • rmi . * ; 
//import java. rmi. server . *; 
import marconi . util . *; 
import marconi .util * rtsp. IRC; 
import marconi . ras . RAS; 
import marconi . ras .MarconiServer; 

/ * * 

* This applet is used by an IRC user. 
* 

* ^author -riK. 

* Gversion $Revision: 1.0 $ 

* ^ee marconi . ras .MarconiServer 

* jfeince prototype vl.O 

public class IRCUsrApplet extends Applet 

^^implements java . io . Serializable, Runnable { 

ffl/** 

Wi * Session Announcement Protocol (SAP) resources. 

1= * Interfaced via. Channel Directory/Description Protocol (CDP) . 

*/ 

L^private MulticastSocket cap_receiver = null; 
^protected Hashtable capCache = null; 

y=/** 

•^n * This thread updates the announcements for the locally supported channels, 

S 

^private Thread directoryThread - null; 
'^private static long L_UPDATE =» 10000; 

// raiscellaneious variables 
private static int widj:h = 0; 
private static int height = 0; 
//protected RAS rasServer = null; 
protected int MAX_CHA!JNELS - 20; 

final static String ol),j_name = "marconi . ras . IRCUsrApplet " ; 
// tools 

IRCDirectory directory = null; 
IRCControls controls = null; 
IRC listener = null; 

/** 

* Initialize the applet and setup display area. 
V 

public void init () { 
try { 

width = Integer .parseint (getParameter( "APPLWIDTH") ) ; 
height = Integer .parseint (getParameter ("APPLHEIGHT") ) ; 



// lookup RAS (MarconiServer) 
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//URL URUq^^n: getDocumentBase 0 ; 

//System. o^^)rintln(obj_name + ".init: locl^^g server"); 
//rasServer = (raS) Naming. lookup ("//" + getParameter ( "RASHost " ) 
// + + getParameter ("RASPort") 

// + "/marconi.ras.MarconiServer") ; 




// init variables 

//MAX_CHANNELS = rasServer , getMaxChannels ( ) ; 
capCache = new HashtableO; 

} 

catch (Exception e) { 
// fatal error 

System. err .println (obj_name + ".init: "); 
e .printStackTrace () ; 



// join CAP multicast group 
try { 

cap_receiver = new Mult icast Socket (MarconiServer. CAP_PORT) ; 
cap_receiver . joinGroup ( InetAddress . getByName (MarconiServer . LOCAL_CAP) ) 

} 

catch (Exception e) { 

System. out .println (obj_name + ".init:"); 
e, printStackTrace () ; 



// draw display area 
setupDisplay 0 ; 

// start 

listener = new IRC(); 

direct oryThread = new Thread (this) ; 

direct oryThread. start () ; 



/** 

* Display the applet. 

public void setupDisplay () { 

setBackground (Color .black) ; 



directory = new IRCDirectory (this) ; 
controls = new IRCControls { ) ; 
GridBagLayout grid = new GridBagLayout ( ) ; 
GridBagConstraints cons = new GridBagConstraints () ; 

// setup grid 

int rowHeights[] - {400, 100}; 
grid.rowHeights = rowHeights; 
setLayout (grid) ; 

cons. fill - GridBagConstraints .BOTH; 
// add directory lists 

cons .gridwidth - GridBagConstraints .REMAINDER; 
cons.weightx = 1,0; 
cons.gridheight » 1; 

grid. setConstraints (directory, cons) ; 
add (directory) ; 
validate () ; 

// add controls 

cons .gridwidth ~ GridBagConstraints .REMAINDER; 
cons.weightx = 1.0; 
cons.gridheight « 1; 
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grid, set Constraint 3 (c^^BrolS/ cons) 
add (controls) ; 
validate 0 ; 

resize (width, height); 



} 



* Free resources when closing applet. 
*/ 

public void destroy () { 

// release sockets and leave announcement group 

cap_receiver.leaveGroup(InetAddress.getByName(MarconiServer.LOCAL_CAP) ) ; 
cap_receiver • close ( ) ; 

} 

catch (Exception e) { 

e.printStackTraceO ; 

} 

stopChannel () ; 
directoryThread = null; 

//try { 

// rasServer .terminate () ; 

a //} 

m //catch (RemoteException e) { 
Ip // e.printStackTraceO ; 

//} 



m 



remove (directory) 
remove (controls) ; 



. / * * 

■■r~* Run method. 

7 public void run() { 



o 



// cache update hour 

long hour = System. currentTimeMillis 0 ; 
/* 

* Global directory thread running. 
*/ 

while (Thread. currentThreadO == directoryThread) { 
/* 

* Receive CDP packets and maintain channel database. 



*/ 

try { 



DatagraraPacket recv_pkt = CDPPacket .compose () ; 
cap_receiver. receive (recv_pkt) ; 

CDPPacket cdp = new CDPPacket (recv^j^kt) ; 

System. out. println{obj_name + ".run: cdp parsed"); 

// update announcement appropriately 
if ( IcapCache.containsKey (cdp.id) ) { 

capCache.put (cdp.id, cdp); ^ ^ ^ u i i. 

System. out. println (Ob j„name + ".run: new cdp cached for channel- 

+ cdp.id) ; 

} 

} 

catch (Exception e) { 
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e.prin^^^ckTrace (} 

// time to refresh cache (daily) 

long current_hour = System. currentTimeMillis 0 ; 

if (current_hour > hour + Time stamp .DAY) ( 

System. out .println (obj.name + ".run: routine -refreshing directory cache."); 

refresh_cache 0 ; 

hour += Timestamp.DAY; 

} 

/* 

* Interval b/w each loop for receiving local channel directory. 
*/ 

try { 

Thread. sleep (L_UPDATE) ; 

} 

catch ( Interrupt edException e) { 
} 



* Removes old cache entries. 
V 

protected void ref resh_cache () { 

long current_hour = System. currentTimeMillis () ; 



synchronized (capCache) { 
;gi Enumeration capList = capCache .elements () ; 

while (capList .hasMoreElements 0 ) { 
^ CDPPacket cdp = (CDPPaclcet) capList .nextElement 0 ; 

HI if (current_hour > cdp . timeStamp + CDPPacket . TTL) { 

4= capCache . remove ( cdp . id) ; 

^ } ^ 

£ /** 

y * Inform server that the specified channel is being listen to. This 

O * RMI based triggering is very inefficient and not scalable. So 

* alternate approach based on RTCP should replace this. 

*/ 

public boolean playChannel (int id) { 
boolean status = false; 

if (capCache .containsKey (String, valueOf (id) ) ) { 

CDPPacket cdp = (CDPPacket) capCache . get (String .valueOf (id) ) ; 
try { 

II kill previous thread if running 
listener. stop 0 ; 

/* 

* The below statement is commented out because the listener 

* is now capable of sending RTCP signals for triggering. 
★ 

status = rasServer .playChannel (id) ; 
*/ 

status = true; // replace above 
listener. start (cdp.MADDR, cdp.MPORT) ; 

} 

catch (Exception e) { 

e.printStackTrace () ; 
return false; 
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return status; 



else { 



return false; 



/ * * 



* Stops listening to whatever is playing. 
V 

public void stopChannel () { 
listener .stop 0 ; 

} 



* Returns the current state of the local channel announcement cache. 
*/ 

protected synchronized Hashtable getCacheO { 
return capCache; 

} 

/** 

* Return applet information. 
„ */ 

Q^ublic String getAppletInf o ( ) { 
m return "IRC listener tool"; 



I -k-k 
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/* marconiNet - Internet Rac^^^etwork 

* Distributed Radio Antenna^BRrver (RAS) : [AD GUI Controls] 
* 

* $<marconi.ras.>ADControls. java -v2 , 0 (prototype version), 1999/05/16 $ 

* @jdkl.2, -riK, 
*/ 

package marconi « ras ; 

import java.awt.*; 

import java.awt .event . *; 

import java.io.*; 

import marconi .util .Vector2; 

/ * * 

* This panel contains user interfaces for the ad insertion. 
*/ 

public class ADControls extends Panel { 
public static RASMgrApplet owner; 
public static Choice ids; 
public static TextField entry_l; 

public static Button button_2, button_3, button_4; 

public static List direct oryList_l ; 

private static int WIDTH = 600; 

private static int HEIGHT = 200; 
private static Vector2 ads = new Vector2{); 
O 

m* Instantiates the control panel. 

—public ADControls (RASMgrApplet main) { 
owner = main; 

m 

ffl GridBagLayout grid = new GridBagLayout ( ) ; 
^ GridBagConstraints cons = new GridBagConstraints ( ) ; 
setLayout (grid) ; 

cons. fill = GridBagConstraints. BOTH; 
cons.weightx = 0.0; 

// channel id 
S ids = new Choice (); 
O updatelDsO; 

n grid. setConstraints (ids, cons) ; 
ids . setForeground (Color .black) ; 

// ids. setForeground (Color. yellow, darker 0 ) ; 

ids . setBackground (Color . lightGray) ; 

// ids. setBackground (Color .black) ; 

add (ids) ; 
validate () ; 

// commercial file input 
entry_l = new TextField (20) ; 
grid. setConstraints (entry_l, cons) ; 
entry_l . setForeground (Color .black) ; 

// ent ry_l. setForeground (Color. yellow. darker 0 ) ; 

entry_l .setBackground (Color. gray. brighter () ) ; 

// entry^l. setBackground (Color. blue. darker 0 , darker () ) ; 

add(entry_l) ; 
validate 0 ; 

// add commercial 

cons.gridwidth = GridBagConstraints .REMAINDER; 
button_2 = new Button (" Add Commercial 
button_2.setActionCommand("Add Commercial") ; 
button_2.addActionListener (RASActionHandler.buttonControl) ; 
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butt on_2 .setBc^^ound (Color. lightGray) ; 
// button_2 .setBacJcground (Color. black) ; 

butt on_2 . setForeground (Color . black) ; 
// but ton_2. setForeground (Color. red) ; 

grid. setConstraints (button_2, cons) ; 
add(button_2) ; 
validate () ; 

// list 

// cons.weightx = 1.0; 

cons .gridwidth = GridBagConstraints . REMAINDER; 
directoryList_l = new List (5, false); 
grid. setConstraints (directoryList_l, cons) ; 
directoryList^l . setForeground (Color .black) ; 

// directoryList_l .setForeground (Color .yellow .brighter ( ) ) ; 

direct or yList_l . set Background (Color .white) ; 

// directoryList_l . setBackground (Color . darkCray) ; 

add(directoryList_l) ; 

validate () ; 

// submit conunercial list 

cons .gridwidth = GridBagConstraints . RELATIVE; 

button_3 = new Button (" Submit List "); 

but t on_3 ,setActionCommand( "Submit Commercials") ; 

button_3 .addActionListener (RASActionHandler .buttonControl) ; 

butt on_3 . setBackground (Color . lightGray ) ; 

// button_3. setBackground (Color .black) ; 

hi button_3 . setForeground (Color .black) ; 

iO // but ton_3. setForeground (Color. red) ; 

gi grid. setConstraints (button_3, cons) ; 

S add(button_3) ; 

~ validate 0; 

1-2 5 

// remove commercial 

cons, gridwidth = GridBagConstraints. REMAINDER; 
Q button_4 = new Button (" Remove All "); 

but ton_4, set Act ionCommand(" Remove Commercials"); 
^ button_4 .addActionListener (RASActionHandler .buttonControl) ; 

butt on_4 . setBackground (Color . lightGray) ; 

// button_4 .setBackground (Color. black) ; 

Q button_4 , setForeground (Color .black) ; 

G / / butt on_4 . setForeground (Color . red) ; 

grid, setConstraints (button_4, cons) ; 

add (butt on_4) ; 

validate () ; 



// resize 

setSize (WIDTH, HEIGHT) ; 



^ to, 



^ * * 

* Add additional entry. 

protected static void processAddO ( 

if (entry_l.getText () .length 0 > 0) { 
try { 

String entry = Integer .parseint (ids. getSelectedltemO ) + " " + entry_l.getT 

r 

directoryList_l . add (entry ) ; 
ads.addElement (entry) ; 

} 

catch (NumberFormatException e) { 

owner. showMessage ("Please select a channel!", true); 

} 
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} 

// clear input fields 
entry^l , setText ( " " ) ; 

} 

I -k-k 

* Remove all entries. 
*/ 

protected static void processRemove ( ) { 
if (ads.sizeO > 0) { 

directoryList_l . removeAll ( ) ; 
ads . removeAllElements ( ) ; 

} 

} 

/ * * 

* Submit the commercial list to the server. 
*/ 

protected static void processSubmit ( ) { 
try K 

if (ads.sizeO > 0 && owner . rasServer . submitCommercialList (ads . toStringArray ()) ) 

{ 

owner . showMessage ( "Commercial list submitted...", false); 
processRemove () ; 
O ent ry_l . setText ( " " ) ; 

} 

Iff else { 

owner .showMessage ("Commercial list could not be submittedl", true); * 
} J 

„ } 

y catch (Exception e) { 

Hi owner .showMessage ("Commercial list could not be submitted!", true); 

£ } 

L ^ 

in 

^ /** 

* Updates available channel ids. 

1=^ V 

iO protected static void updatelDs () { 
O ids . removeAll ( ) ; 

^ for (int i = 0; i < owner .channellDs . length; i++) { 
if (owner .channellDs [i] ) { 

ids.add(String,valueOf (i) ) ; 

} 

} 

if (ids.getlteraCount 0 0) { 
ids. add ("EMPTY") ; 



\ 
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/* marconiNet - Internet Rac^^Metwork 

* Distributed Radio Antenna^Prver (RAS) : [Channel Class] 
* 

* $<marconi.ras.>Channei. java -v2 . 0 (prototype version), 1999/01/06 $ 

* @jdkl.2, -riK. 
V 

package marconi.ras? 

import java.io.*; 
import java.net**; 
import java.util.*; 
import java.rmi.*; 
import marconi . util . * ; 
import marconi. util.rtsp.*; 
import marconi . rsc .RSC; 
import java. security . Security; 
import javax . crypto • * ; 
import javax , crypto . spec . * ; 

import au.net .aba. crypto. provider .ABAProvider ; 
/ * * 

* The <code>Channel</code> class creates two threads in which it can start 

* the neccessary operations for maintaining the channel. First, it creates 

* a thread that listens and monitors the RTCP signals from IRCs. When this 

* thread detects that there is at least one IRC that wants to listen to this 

* ^annel, it creates the second thread which begins performing the redirection 

* process (receive content from global address, decrypt, write content to 

* iipcal address) . The <i>rtcp thread</i> continues the monitoring so that 

* !ik it detects that no one is listening to the channel anymore it terminates 

* '^e <i>redirection thread</i>. This helps reduce the bandwidth being wasted. 

* Additionally, <code>Channel</code> will store the details of its content 

* provider (radio station) and the broadcast/multicast medium. 

* Wp> 

*.g(@author -riK, 

* ^version $Revision: 1.0 $ 

* 3fsee marconi. ras.MarconiServer 
♦ ^see marconi . ras . StationProf ile 
*Hsince prototype vl.O 

pugtic class Channel implements Runnable { 

^final static String obj„name = "marconi .ras .Channel"; 



/** 

* The assigned channel number. 
*/ 

protected int chanID; 
/** 

* The radio station. 
*/ 

private RSC station = null; 
/** 

* The radio station's hostname. 
*/ 

private String host = null; 



* The radio station name. 
*/ 

public String name « null; 



/** 
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ategc^^^f this channel's content {mus 





iws I sports I . . . } . 



public String category = null; 
/** 

* The content description, 
V 

public String description = null; 
^ ★ ★ 

* The origin of the content. 
*/ 

public String origin = null; 
/* * 

* The language used in the content . 
*/ 

public String language - null; 

I -k-k 

* The radio station's url (not in use by the current protocol). 
V 

public URL url = null; 
^ ** 

* The station's glocal multicast address. 
V 

protected XnetAddress g_maddr; 

/ * * \ 

* The station's local multicast address. 
*/ 

protected XnetAddress l__maddr; 
/* 

* The encryption resources. These private declaration allows for later 

* extension where the hard-coded values such as the SEK algorithm and key 

* length can be obtained from announcement. In such cases various encryption 

* methods can be supported and allows the encrypting party (content sender) to 

* decide on which algorithm to use. 
*/ 

private byte[] SEK = null; // session encryption key 

int sek_id « -1; // RSC registration id 

byte[] publicKey null; // RSA public key 

byte[] privateKey = null; // RSA private key 

private final static String SECRET_ALG = "RC4"; // encryption algorithm 
private final static int SEKLEN =8; // encryption key length 

* Channel database initialized (install JCE and thread counter) . 
V 

private static boolean DB_INITIALIZED « false; 
* 

* Daily program schdule. 
*/ 

private Hashtable programSchedule = null; 
/** 

* Daily commercial schedule. 
V 

private Hashtable commercialSchedule * null; 
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* The radio antenna sei^^^ can activate the channel broa^^^ting by 

* starting this <code>c^BmelThread</code> . 

*/ 

private Thread channelThread = null; 
y * * 

* The channel broadcasting does not actually begin unless this RTCP listener 

* thread detects that there is at least one listener present at the time. 
*/ 

private Thread rtcpThread = null; 
/ * * 

* This variable indicates the state of the thread (active or suspended) . 
*/ 

private boolean threadSuspended = false; 
/ * * 

* Manages the number of running threads (channels) . 
*/ 

protected static ThreadCountManager threadCounter = null; 
/ ★ * 

* The RTCP listener, 
*/ 

private RTCPListener rtcpListener = null; 
Qprivate RTCPSocket rtcpRegistry = null; 

Multicast resources. 

2byte recv_buf[]; // receiver buffer 

&yte sendL_buf[]; // receiver buffer 

OlDatagramPacket recv_pack; // receiver packet 

:£DatagramPacket send_pack; // receiver packet 

/ private MulticastSocket recv_msock; // multicast socket for receiving 

J:;^private MulticastSocket send_msock; // multicast socket for sending 

^private boolean SOCKET_IN_USE = false; // prevents abrupt socket kill 
yi 

/ ★ ★ 

sn * Creates a new thread and starts the <code>Channel</code> operation 
Q * which consists of broadcasting (multicasting) the channel contents 
^ * to its local clients and storing the station profile. 

* @param chan_id the channel number. 

* Gparam maddr the local multicast address. 
*/ 

public Channel (int chan_id, InetAddress maddr) { 

// install jce provider 
if (!DB_INITIALIZED) { 

threadCounter = new ThreadCountManager ( ) ; 

DB.INITIALIZED = Security . addProvider (new ABAProvider () ). > -1; 

} 



// initialize channel 
chanID = chan_id; 

programSchedule = new Hashtable () ; 
commercialSchedule = new Hashtable (); 
g_maddr = null; 
l_maddr = maddr; 



// initialize rtcp listener 

rtcpRegistry = new RTCPSocket (MaddrDispenser. rtcp_map (maddr) , 

MarconiServer . IRC_P0RT+1, true) ; 
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rtcpListener =^^^ RTCPListener ( rtcpRegistry, M^^MJispenser . addr_to_int (maddr) ) ; 
rtcpListener . swR ( ) ; 
rtcpThread ~ new Thread (this) ; 
rt cpThread . start ( ) ; 

} 

* This <code>run</code> method implements the channel's broadcast 

* operation. 
*/ 

public void run() { 
/* 

* Channel thread running. 
*/ 

while (Thread. current Thread {) =- channelThread) { 

// receive audio packet 
SOCKET_IN_USE « true; 
try { 

// init receiving packet 

recv„buf = new byte [Marconi Server .MAX_PAYLOADLEN 

+ MarconiServer.MAX.RTPHDRLEN] ; 
recv_pack = new DatagramPacket (recv_buf , recv_buf. length) ; 
_ recv„msock. receive (recv_pack) ; 

O 

m //System.out.println ("received RTP from " + recvjsack . getAddress ( ) + + i 

In- cvj>ack.getPort 0 ) ; 

B > 

~ catch (Exception e) { i 
H: System. out .println (obj_name + ".run: channel-" + chanID) ; 

^ e, print StackTrace () ; 

£ SOCKET_IN_USE = false; 

// Decrypt & send local 
™ int n = recv_pack.getLength () ; 

if (n > 0 && SEK != null) { 
H try { 

m //Cipher cipher = Cipher .get Instance (SECRET_ALG) ; 

p //cipher. init (Cipher. DECRYPT_MODE, new SecretKeySpec (SEK, SECRET_ALG) ) ; 

//byte[] send__buf = cipher .doFinal(recvj)ack.getData ()) ; 
byte I ] send_buf = recv^ack . getData () ; 
send_jpack = new DatagramPacket (send_buf , n, l__maddr, 

MarconiServer . IRC_PORT) ; 
send_msock.send(send_pack, (byte) MarconiServer .LOCAL_TTL) ; 
//System.out.println ("sent to " + send_pack . getAddress () + ":" + send_pi 



f k.getPortO); 



) 

catch (Exception e) { 

System. out •println(obj_name + ".run: "); 
e. print StackTrace () ; 

} 



} 



/* Uncomment below to use variable sleep feature, (and comment above) 

* Sleep, (accordingly wrt # of running channels) 

*/ 

try { 

Thread .sleep (threadCounter . get SleepTime ( ) ) ; 



synchronized (this) { 

while (threadSuspended && channelThread !» null ) { 
wait ( ) ; 



ConanexcialSchedule. java Thu JXin 17 14:24:39 1999 



public CommercialS^^pule (int freq) { 
N_BREAKS » fre^^ 

breaks = new CommercialBreak [N_BREAKS ] ; 



// allocate breaks with slots 
for (int 1=0; i < N_BREAKS; i++) { 
breaks(i] = new CommercialBreak () ; 

} 

} 

/** 

* Goes to next commercial break, 
*/ 

public void nextBreakO { 

breakCounter = (breakCounter + 1) % N_BREAKS; 
slot Counter = -1; 



} 



/★ * 

* Gets the next advertisement id in schedule. 
*/ 

public String nextSlotO { 
_ if (breakCounter < 0) { 

□ nextBreakO; 

^ slotCounter = (slotCounter + 1) % breaks [breakCounter] .N_SLOTS; 

~ return breaks [breakCounter] , getCommercial (slotCounter) ; 

m 

m /** 

^ * Returns the available time slots for advertisement. Each vector element is 

* associated with a commercial break, which has 8 (default) possible slots. 
Q * These 8 slots are represented by a <code>binary string</code> where a '1' 



* means that the slot is occupied. 



* ereturn a vector of bytes which represents the available commercial slots. 
*/ 

public synchronized Vector getTimeSlots () { 
Vector breakList = new Vector (); 

for (int i = 0; i < N_BREAKS; i++) { 

breakList .addElement (breaks [i] .get Bitmap () ); 

} 

return breakList; 

} 

/* * 

* Sets the requested time slot for the given advertisement. 
*/ 

public boolean setTimeSlot (int break_id, int slot_id. String adLid) { 
return breaks [break^id] .reserveSlot (slot_id, ad^id) ; 

} 



* Each commercial break consists of the following: 

* <ul> 

* <li>the number of slots for this break (does not neccessarily have to 

* be 8 but the prototype should use this default value) ; 

* <li>array of slots that contains the commercial ids; 

* </ui> 

* <p> 
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* @author -riK, 

* ^version $Revision: 1.0 $ 

* esince prototype vl . 0 
V 

:lass CommercialBreak { 



* The number of commercial slots per each break. 
V 

public final int N_SLOTS = 8; 
/* 

* This prototype version does not use the below parameter... 
★ 

private Date breakTime; // beginning of the commercial break time 
V 

/* 

* 8-bits are used to represent 8 commercials. Each bit maps to a 30 second 

* commercial. 
V 

private int bitmap; 

Ul* The array of slots that contain advertisement id. 
«*/ 

|rprivate String [] slots; 

|/* 

Constructor for commercial break. 

|v 

y =public CommercialBreak 0 { 
-f this. bitmap = 0; 

slots = new String [N_SLOTS] ; 

rf* Check to see if all the slots are full. 

m*/ 

□ protected synchronized boolean isFullO { 

p return (bitmap >= (1 « N.SLOTS) - 1) ? true : false; 
} 

/* 

* Get the bitmap representation of the slots. 
*/ 

protected String getBitmapO { 

return Integer .toBinaryString (bitmap) ; 

} 

/* 

* Set the bit for the requested time slot. Slots are of course 0-based (0 
*/ 

protected synchronized boolean reserveSlot (int slot. String ad_id) { 
if (isFullO) { 
return false; 

} 

int slotJ:)it = 1 « slot; 
if ((bitmap & slot_bit) > 0) { 
return false; 

} 

else { 



CommercialSchedule . java 



Thu Jun 17 14:24:39 1999 



bitmap |= M 
slots [slot" 
return true; 




|_bit; 
ad_id; 




/* 

* Reserve any available time slot; 
*/ 

protected synchronized boolean reserveSlot (String ad_id) 
if (this.isFullO ) { 
return false; 

} 

boolean success = false; 
for (int i = 0; i < N_SLOTS; i++) { 
if (slots [i] ~ null) { 



/* 

* Get the specific commercial. 
*/ 

protected synchronized String getCommercial (int slot) { 
return slots [slot]; 

} 



bitmap |= 1 << i; 
slots [i] = ad__id; 
success = true; 
break; 



return success; 
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/* marconiNet - Internet Rad 

* Distributed Radio Antenna "^^rver (RAS) 



fBetwork 
rver (RAS) : [RAS Action Handle^^ 



* 



* $<marconi.ras->RASActionHandler. java -v2 . 0 (prototype version), 1998/02/17 

* 0jdkl,2, *riK. 
*/ 

package marconi.ras; 



import j ava . awt . * ; 
import java , awt . event , 



* < 



/ * * 

* This class handles two action commends, particularly <code>Ok</code> and 

* <code>Toggle</code> buttons. 
*/ 

public class RASActionHandler { 

public static ActionListener buttonControl = new ActionListener () { 
public void actionPerf ormed (ActionEvent e) { 
String command = e.getActionCommandO ; 
if (command, equals ("Ok") ) { 

RASControls.processCommandO ; 

} 

else if (command. equals ("Toggle") ) { 
RASCont rols . toggleButton ( ) ; 

} 

p else if (command. equals ("Add Commercial")) { 

^ ADControls .processAddO ; 

m } 

else if (command. equals ("Submit Commercials")) { 
^ ADControls .processSubmit () ; 

S } 

iy else if (command. equals ("Remove Commercials")) { 

gl ADControls .processRemove {) ; 

!^public static ActionListener listControl » new ActionListener () { 
H public void actionPerf ormed (ActionEvent e) { 
m if (RASControls.actionDisplay .equals ("Add") ) { 

fi RASControls . entry_l . setText 

S (RASDi rectory . directoryList_l . get Item 

(RASDirectory,directoryList_l .getSelectedlndex 0 ) ) ; 

} 

} 

}; 
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/* marconiNet - Internet Rad^^etwork 

* Distributed Radio Antenna^Kver (RAS) : [RAS GUI Controls 
* 

* $<marconi.ras.>RASControls. java -v2 . 0 (prototype version), 1999/02/15 $ 

* @jdkl.2, -riK. 
V 

package marconi • ras ; 

import java.awt . *; 
import j ava . awt . event • * ; 
import j ava . ut il . * ; 

/ * * 

* This panel contains user interfaces to the applet. 
*/ 

public class RASControls extends Panel { 
public static RASMgrApplet owners- 
public static Choice ids; 
public static TextField entry_l; 
public static Button button_l; 
public static Button button_2; 
public static String actionDisplay; 
private static int WIDTH = 600; 
private static int HEIGHT * 50; 



Instantiates the control panel. 

'% */ 

public RASControls (RASMgrApplet main) { 

^ owner = main; 

61 actionDisplay = "Add"; 

S GridBagLayout grid = new GridBagLayout {) ; 

GridBagConstraints cons = new GridBagConstraints () ; 
^ setLayout (grid) ; 

i_ cons. fill = GridBagConstraints. NONE; 
O cons.weightx = 0.0; 

// define toggle button 
^ button_l = new Button (" " + actionDisplay + " "); 
^ button_l . setAct ionCommand ( "Toggle" ) ; 

y button_l .addActionListener (RASActionHandler .buttonControl) ; 
O butt on_l. set Background (Color. lightGray) ; 

// button_l.setBackground (Color. black) ; 

button_l . setForeground (Color .black) ; 

/ / button_l . setForeground (Color . red) ; 

add(button_l) ; 

validate 0 ; 

// channel id 

ids = new Choice (); 

updatelDs 0 ; 

grid. setConstraints (ids, cons); 
ids. setForeground (Color. black) ; 

// ids .setForeground (Color .yellow. darker 0 ) ; 

ids . setBackground (Color • lightGray ) ; 

/ / ids . setBackground (Color .black) ; 

add (ids) ; 

validate () ; 

// selected station (multicast address + name) 
entry_l = new TextFieldOO) ; 
grid.setConstraints (entry_l, cons) ; 
ent ry_l . setForeground (Color .black) ; 
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// entr^^^etForeground (Color. yellow .dar^M) ) ; 

entry_l -setBack^^nd(Color.gray. brighter 0 ) ; 

/ / ent ry_l.setBackground (Color, blue, darker 0 .darker () ) ; 

add(entry_l) ; 
validate {) ; 

// add global to local 

cons-gridwidth = GridBagConstraints .REMAINDER; 
button_2 = new Button (" Ok 
button_2 .setActionCommandCOk") ; 

button_2 .addActionListener (RASActionHandler .buttonControl) ; 

button_2 . setBackground (Color . lightGray) ; 

// button_2. setBackground (Color. black) ; 

button_2 . setForeground (Color . black) ; 

/ / button_2 . setForeground (Color . red) ; 

grid.setConstraints (button__2, cons) ; 

add(button_2) ; 

validate 0; 

// resize 

setSize (WIDTH, HEIGHT) ; 

} 

/ ** 

D * Carries out the specified action, 

a */ 

LH public static void processCommand () { 

m II if action is "Add" 

.-pl if (actionDisplay. equals ("Add") ) { 

2 string textfield = entry_l .getText () ; 

4j String id_str = ids.getSelectedltemO ; 



if (textfield. indexOf(", ") > 0 id_str != null) { 

StringTokenizer dir = new StringTokenizer (textfield, ", ") ; 
String ma = dir .nextToken () ; 
String name = dir .nextToken () ; 
int id = Integer. parseint (icLstr) ; 
if (owner. addChannel (id, ma)) { 

owner. showMessage ("Added new channel...", false); 

updatelDs 0 ; 

} 

else { 

owner. ShowMessage ("Channel could not be added...", true); 

} 

} 

else { 

owner.sho%rt4essage( "Select a station from global directory. 

} 



//if action is "Remove" 

else if (actionDisplay. equals ("Remove") ) { 
String id^str = ids.getSelectedltemO; 

if (id_str !- null) { 

int id = Integer. parseint (id_str) ; 
if { owner. removeChannel (id) ) { 

owner. ShowMessage ("Removed channel " + id + "...", false); 
updatelDs () ; 

} 

else { 

owner. showMessage ("Channel could not be removed,..", true); 

} 
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else { — — 

owner. showMessage ("No channel to remove..."/ true) ; 

} 

} 

// clear input fields 
entry_l. set Text {"") ; 

} 

/ * * 

* Implements the toggle mechanism for the control button; 
*/ 

public static void toggleButton ( ) { 

//if button label says "Add", change it to "Remove" 
if (actionDisplay. equals ("Add") ) { 
actionDisplay = "Remove"; 

owner. ShowMessage ("Please select a channel to remove...", false); 
update IDs () ; 

) 

//if button label says "Remove", change it to "Add" 
else if (actionDisplay .equals ("Remove") ) { 
actionDisplay = "Add"; 
□ owner .showMessage ("Please select a station to add...", false); 

^ updatelDs () ; 

m > 

button 1 . setLabel (actionDisplay) ; 

m 

^ * Updates available channel ids. 

r V 

public static void updatelDsO { 
5 ids . removeAll ( ) ; 

ffl 

if (actionDisplay. equals ("Remove") ) { 

for (int i = 0; i < owner. channellDs. length; i++) { 
if (owner. ChannellDs [i] ) { 

ids. add ( String. valueOf (i) ) ; 

} 

} 

) 

else { 

for (int i " 0; i < owner. channellDs. length; i++) { 
if (! owner. channellDs [i] ) { 

ids. add (String. valueOf (i) ) ; 

} 

> 

} 



'(■. 



a 



i 
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/* marconiNet - Internet Radi^Network 



* 



Ldi^^etwork 

* Distributed Radio Antennd^^ver (RAS) : [RAS Directory Co^Hls] 



* $<marconi.ras->RASDirectory. java -v2 . 0 (prototype version), 1999/02/15 $ 

* @jdkl,2, -riK. 
*/ 

package marconi.ras; 

import java.awt.*; 
import java.awt .event . *; 
import java.util .Enumerations- 
import java.io.*; 
import marconi.util . *; 

/ * ★ 

* This panel contains user interfaces to the applet. 
*/ 

public class RASDirectory extends Panel 
implements Runnable { 

/ * ★ 

* This thread periodically downloads global channel announcements (CAP) cache, 
*/ 

private Thread g_directoryThread = null; 
/ * * 

□ * This thread updates the announcements for the locally supported channels. 

3 */ 

l^private Thread l_directoryThread = null; 

:f /** 

* The global announcement update interval. 

m */ 

giprivate static long G_UPDATE = 20000; 

1_ * The local announcement update interval. 

9 */ 

y-^private static long L_UPDATE = 20000; 

^public static RASMgrApplet owner; 

public static Label label_l; 

public static List direct oryList_l; 
'^public static Label label_2; 

public static List direct oryList_2; 

private static int WIDTH =« 600; 

private static int HEIGHT =- 200; 

/ * * 

* The file dump. 
V 

public final static File file ^ new File ("_mapsta") ; 
/** 

* Instantiates the directory display panel. 
*/ 

public RASDirectory (RASMgrApplet main) { 
owner = main; 

GridBagLayout grid = new GridBagLayout () ; 
GridBagConstraints cons = new GridBagConstraints () ; 
setLayout (grid) ; 

cons. fill = GridBagConstraints. NONE; 

setFont (new Font ("Helvetica", Font. BOLD, 24)); 
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// label 1 
cons.weightx 
label_l = new Label () ; 

label_l .setText (" Global Channel Directory 
grid. setCpnstraints (label_l, cons) ; 
label_l . setForeground (Color .black) ; 
// label_l . setForeground (Color .white) ; 

adddabeU) ; 
validate () ; 

// label 2 

cons .gridwidth ~ GridBagConstraints .REMAINDER; 
labei_2 = new Label (); 

label_2 . setText (" Local Channel Directory ") ; 

grid. setConstraints (label_2, cons) ; 

label_2 . setForeground (Color .black) ; 

// label_2.setForeground (Color. white) ; 

add(label_2) ; 

validate () ; 

setFont(new Font ("Helvetica", Font. PLAIN, 14)); 
// list 1 - global 

cons, gridwidth = GridBagConstraints .RELATIVE; 
directoryList_l = new List (10, false); 

directoryList_l . addActionListener (RASActionHandler . listControl) ; 
grid. setConstraints (direct oryList_l, cons) ; 
directoryList_l . setForeground (Color .black) ; 
directoryList_l . setBackground (Color. white) ; 

// directoryList_l . setForeground (Color .yellow.brighter () ) ; 

// directoryList_l . setBackground (Color .darkGray) ; 

add (directoryList_l) ; 
validate () ; 

// list 2 - local 

cons .gridwidth = GridBagConstraints . REMAINDER; 
directoryList_2 = new List (10, false); 

// directory List_2 .addActionListener (RASActionHandler .listControl) ; 

grid. setConstraints (direct oryList_2, cons) ; 
directoryList_2 . setForeground (Color .black) ; 
directoryList_2 .setBackground (Color. white) ; 

// directoryList_2. setForeground (Color, yellow. brighter 0 ) ; 

/ / directoryList_2 . setBackground (Color . darkGray) ; 

add (directoryList_2) ; 
validate () ; 

// resize 

setSize (WIDTH, HEIGHT); 
start (); 

* Starts the directory update. 
*/ 

public void start () { 

g__directoryThread = new Thread (this) ; 
g_directoryThread. start () ; 
l_directoryThread - new Thread (this) ; 
l_directoryThread . start ( ) ; 




* The run methods for the two threads. 
V 
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public void run<) { 

// global directory 

while (Thread. cur rentThreadO == g_directoryThread) { 
PrintWriter fout = null; 

try { 

Thread. sleep (G_UPDATE) ; 

fout =* new PrintWriter (new Buf feredWriter (new FileWriter (f ile) ) ) ; 
Enumeration enum = owner . rasServer.downloadCAP (false) .elements () ; 
Vector2 ip_addr = new Vector2 () ; 
Vector2 name = new Vector2(); 

while (enum.hasMoreElements () ) { 

CDPPacket cdp - (CDPPacket) enum. next Element () ; 

ip_addr . addElement (cdp.MADDR) ; 

name . addElement (cdp . name) ; 

fout .println (cdp.MADDR + " " + cdp. name); 

} 

displayDirectory (ip_addr . toStringArray () , name . toStringArray ( ) ) ; 
fout .close 0 ; 

} 

catch (Exception e) { 

e . print StackTrace ( ) ; 

t ) 



m 



} 



// local directory ^ 
ffl while (Thread. current Thread 0 == l_directoryThread) { t 

^ Thread. sleep {L_UPDATE) ; 

%1 Enumeration enum = owner .rasServer.downloadCAP (true) .elements {) ; 

Vector2 ip_addr = new Vector2(); 
l_ Vector2 name = new Vector2(); 

O Vector2 id = new Vector2(); 

ffl 

1^ while (enum.hasMoreElements {) ) { 

■ f- CDPPacket cdp = (CDPPacket) enum.nextElement () ; 

i: ip_addr . addElement (cdp .MADDR) ; 

5 name . addElement ( cdp . name ) ; 

C id. addElement (cdp. id) ; 

} 

displayDirectory (ip.addr. toStringArray 0 , name. toStringArray () , 
id. toStringArray 0 ) ; 

} 

catch (Exception e) ( 
} 

} 

} 

protected static void displayDirectory (String [1 ip_addr. String [] name) { 

if (directoryList_l .getltemCount {) > 0) 

direct oryList_l . removeAll () ; 
for (int i = 0; i < ip_addr. length; i++) { 

directoryList_l.add(ip_addr [i] + " + name[i]); 

} 

} 

protected static void displayDirectory (String [] ip_addr. String [1 name. String [] id) { 
if (direct oryList_2. get ItemCount 0 > 0) 

directoryList_2 • removeAll ( ) ; 
for (int i = 0; i < owner .MAX_CHANNELS; i++) { 
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directoryL^^2.add(String-valueOf (i) ) ; 

for (int i = 0; i < ip_addr . length; i++) { 

directoryLi3t_2.replaceItem(id[i] + " " + ip_addr[i] + " + name[il. 

Integer, parselnt (id[i] ) ) ; 

} 

} 

protected static void displayDirectory (String ip_addr. String name) { 
directoryList_l.add(ip_addr + " + name); 

} 

protected static void displayDirectory (String ip_addr, String name. String id) ( 
directoryList_2.replaceItem(id + ip_addr + " + name. Integer .parselnt (id) ) 
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/* marconiNet - Internet Ra<^^^etwork 

* Distributed Radio Antenn^^Rrver (RAS) : (RAS Manager InteSRe] 

* $<marconi.ras.>RASManager . java -v2 . 0 (prototype version), 1999/02/15 $ 

* 8jd]cl.2, -riK. 
*/ 

package marconi - ras; 
import java . rmi . * ; 
/*★ 

* This interface is provided for the RAS to write alarming texts at the remote manager. 

* @author ^-riK. 

* ^version $Revision: 1.0 $ 

* @see marconi. ras. MarconiServer 

* @since prototype vl.O 
*/ 

public interface RASManager extends Remote { 

I -k-k 

* Write various messages (error messages) . 
*/ 

public void showMessage (String msg, boolean blink) 
throws RemoteException; 

} 0 

w 
m 

01 



a 
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/* marconiNet - Internet Rad^^twork j^B 

* Distributed Radio Antenna slfver (RAS) : [RAS Messageboard DWplay] 

* $<marconi.ras.>RASMessageBoard. java -v2 . 0 (prototype version), 1999/02/15 $ 

* 0jdkl.2, -riK. 
V 

package marconi . ras; 

import java.awt . *; 
import java.net.*; 
import java . applet . * ; 

/ * * 

* This message borad is used to display messages in a scrolling fashion. 

* The content of the message is updated by directly accessing and changing 

* the public variables <code>text</code> and <code>blink</code> . 

* If <code>blink</code> is set to <code>true</code>, the message stored in 

* <code>text</code> will scroll and also iblink!; this feature is 

* particularly for alarm (error) messages. 

public class RASMessageBoard extends Applet 
implements Runnable { 

// publically accessable vars 
public String text = 
public boolean blink = false; 

i^/ awt vars 
int shiftCnt = 0 ; 
jgirivate Font font; 

private static Color fgcolor = Color. blue; 
qp>rivate static Color bgcolor = Color . lightGray; 
0|)rivate Color color = fgcolor; 
private Image of fScr Image = null; 
..'private Graphics of f ScrGraphics = null; 
Iprivate Dimension offScrSize = null; 

Slrhread thread = null; 

■■tfl/ * * 

* Even though this object extends from an applet, it is not to be 

^ * the main applet and thus is instantiated via a constructor; you may 
^ * set it to display some initial text; 
*/ 

public RASMessageBoard (String initial_text) { 

// initialize text field 
this. text = initial_text; 

// measure screen width 
shiftCnt =* getSize () .width; 

// setup font 

font = new Font ("Helvetica", Font. PLAIN, 16); 
setFont (font) ; 
start ( ) ; 

} 

/*★ 

* Start the thread; 
V 

public void start () { 

if (thread ^= null) { 

thread = new Thread (this) ; 
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2 



thread, sta: 




/ * ★ 

* Stop the thread; 
V 

public void stopO { 
thread = null; 

} 

/ * * 

* Thread body; blinking feature is implemented by toggling text color 

* b/w background and foreground here after each pause; 
*/ 

public void run() { 
int i = 0; 

while (Thread, current Thread () === thread) { 



// pause 
try { 

Thread .current Thread 0 .sleep(200) ; 

} 

catch (InterruptedException e) { 
} 

// blink -> toggle colors b/w black and yellow 

// it remains black for 2 pause periods and yellow for 4 periods 
// otherwise -> stay yellow 
if (blink) 

color = (i++ < 2) ? bgcolor : fgcolor; 

else 

color ~ fgcolor; 

// update drawing 
repaint () ; 

i = (i > 6) ? 0 : i; 



public synchronized void update (Graphics g) { 
FontMetrics fMetric; 
fMetric = getFontMetrics (f ont ) ; 
Dimension d = getSizeO; 

// create off -screen image 

if ( (offScrlraage — null) I I (d. width of fScrSize, width) || 
(d, height !» off ScrSize. height ) ) { 
offScrlraage - createlmage (d. width, d, height); 
offScrSize » d; 

of f ScrGraphics = offScrlmage.getGraphics () ; 
offScrGraphics.setFont (font) ; 



// setup off-screen image 

of f ScrGraphics . setColor (bgcolor) ; 

offScrGraphics.fillRect (0, 0, d. width, d. height ) ; 

off ScrGraphics. setColor (color) ; 

off ScrGraphics .setFont (font) ; 

if ((shiftCnt + f Met ric.stringWidth (text) ) <= 0) 
shiftCnt « d. width; 



} 



* Updat 
*/ 



e display (move the message to the left) . 
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// shift left & writ^^fessage 

shiftCnt = shiftCnt - 5; 

of fScrGraphics. drawstring (text, shiftCnt, (int) (d.height * 0,65)); 
g.drawlmage (off Scr Image, 0, 0, null) ; 

} 



m 

01 



Q 
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la^Rver (RAS) : [RAS Manager Applel^ 



/* marconiNet - Internet Rac 

* Distributed Radio Antenna^ 
* 

* $<marconi.ras*>RASMgrApplet . java -v2 . 0 (prototype version), 1999/02/15 $ 

* 0jdkl.2, -riK, 
*/ 

package marconi ♦ ras; 

import java . applet . * ; 

import java.awt.*; 

import java.util • *; 

import java.net .URL; 

impo rt j a va . rmi . * ; 

import j ava . rmi . server • * ; 

/ * * 

* This applet is used by a RAS manager (operator) who monitors and configures 

* the MarconiServer . 
* 

* Sauthor -riK. 

* @version $Revision: 1.0 $ 

* @see marconi . ras .MarconiServer 

* @since prototype vl.O 
*/ 

public class RASMgrApplet extends Applet 

=4mplements RASManager, java. io. Serializable { 

w 

^/ miscellaneious variables 
yprivate static int width = 0; 
■tyjrivate static int height = 0; 
gprotected RAS rasServer = null; 
l^protected int MAX_CHANNELS = 0; 
protected static boolean [] channellDs; 

^inal static String obj_name = "marconi .ras .RASMgrApplet"; 
s // tools 

QE^SDirectory directory = null; 
g^flASControls controls = null; 
r=ADControls ad_controls - null; 
^^^SMessageBoard msgBoard = null; 

y=r- 

O * Initialize the applet and setup display area. 
V 

public void init () { 
try { 

width = Integer. parseint (getParameter(" APPLWIDTH") ) ; 
height « Integer. parseint (getParameter ("APPLHEIGHT") ) ; 

// lookup RAS (MarconiServer) 
URL URLbase " getDocuraentBase 0 ; 

System. out .println (obj_name + ".init: locating RAS"); 

rasServer » (RAS) Naming. lookup ("//" + URLbase. getHost () + ":" 

+ getParameter ("RASPort") 
+ "/marconi . ras. MarconiServer") ; 



// init variables 

MAX_CHANNELS = MarconiServer .MAX_CHANNELS; 

} 

catch (Exception e) { 
// fatal error 

System. err. println (obj^narae + ".init: "); 
e . print St ackTrace ( ) ; 
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channellDs = n^^PSoolean [MAX_CHANNELS] ; 
for (int i = 0; i < channellDs . length; i++) { 
ChannellDs [i] = false; 

} 

// draw display area 
setupDisplay 0 ; 

} 

/** 

* Display the applet, 
*/ 

public void setupDisplay () { 
Label label_l; 

setBackground (Color . lightGray) ; 

directory = new RASDirectory (this) ; 
controls = new RASControls (this) ; 
ad_controls = new ADControls (this) ; 

msgBoard = new RASMessageBoard ("Initializing RAS..."); 
GridBagLayout grid = new GridBagLayout ( ) ; 
GridBagConstraints cons = new GridBagConstraints () ; 

// setup grid 

int rowHeights[] = {10, 200, 50, 200, 90}; 
grid.rowHeights = rowHeights; 
set Layout (grid) ; 

cons. fill = GridBagConstraints. BOTH; 
// label 1 

Font font = new Font ("Arial", Font .BOLD, 24); 
set Font (font) ; 

cons .gridwidth GridBagConstraints .REMAINDER; 

label_l = new Label ("- RAS MANAGER -", Label . CENTER) ; 

grid. setConstraints (label_l, cons) ; 

label„l . setForeground (Color .black) ; 

add(label_l); 

validate {) ; 

setFont (new Font ("Arial", Font. PLAIN, 14)); 
// add directory lists 

cons. gridwidth = GridBagConstraints .REMAINDER; 
cons.weightx = 1.0; 
cons.gridheight =» 1; 

grid. setConstraints (directory, cons) ; 
add (directory) ; 
validate () ; 

// add controls 

cons, gridwidth « GridBagConstraints .REMAINDER; 

cons.weightx -1.0; 

cons.gridheight « 1; 

grid. setConstraints (controls, cons) ; 

add (controls) ; 

validate () ; 

// add ad-insertion controls 

cons. gridwidth =» GridBagConstraints .REMAINDER; 
cons.weightx =» 1.0; 
cons.gridheight = 1; 

grid. setConstraints (ad_controls, cons) ; 
add(adLcontrols) ; 
validate 0 ; 
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// add message scro board 

cons.gridwidth = GridBagConstraints .REMAINDER; 

cons.weightx = 1.0; 

cons. weighty = 1.0; 

cons .gridheight - 1; 

grid.setConstraints (msgBoard, cons) ; 

add(nisgBoard) ; 

validate () ; 

resize (width, height) ; 

} 

/** 

* Close down the server when closing applet, 
*/ 

public void destroy () { 

if (rasServer != null) { 
try { 

rasServer , shutdown ( ) ; 
remove (directory) ; 
remove (msgBoard) ; 
remove (controls) ; 

} 

n catch (RemoteException e) { 

e.printStacJcTraceO ; 

I . ' 

^} 

ffl 

fp * Register channel with the server. 

S */ 

/ public boolean addChannel(int id. String ip) { 
L boolean status = false; 
a try { 

ffl status = rasServer. registerChannel (id, ip) 

H } 

catch (RemoteException e) { 

Q e . printSt acJcTrace ( ) ; 

H } 

if (status) { 

channellDs [id] = true; 
update_ctrls 0 ; 

} 

return status; 

} 

/** 

* Remove channel froi% the server. 
*/ 

public boolean removeChannel (int id) { 
boolean status - false; 
try { 

status = rasServer .removeChannel (id) ; 

} 

catch (RemoteException e) { 
} 

if (status) { 

ChannellDs [id] = false; 
update_ctrls 0 ; 

} 

return status; 
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* Update tools upon action taken, 
*/ 

private void update_ctrls ( ) ( 

// controls.updatelDs 0 ; 

ad_controls.updateIDs 0 ; 

} 

/ * * 

* Write various messages (error messages) . 
*/ 

public void showMessage (String msg, boolean blink) 
msgBoard. text = msg; 
msgBoard. blink = blink; 

} 

/ * * 

* Return applet information. 
*/ 

public String getAppletInf o () { 

return "RAS configuration/management tool"; 

} 
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la^Kver (RAS) : [RTSP Server Cont^Ke 



/* marconiNet - Internet Rac 

* Distributed Radio Antenna'^ftver (RAS) : [RTSP Server Contr'^Ker] 

* $<marconi.ras.>RTSPServerControl. java -v2 . 0 (prototype version), 1998/1/12 

* @jd)cl,2, -riK. 
*/ 

package marconi-ras; 

import java.io.*; 
import j ava . net . * ; 
import java.util.*; 

/** 

* This class provides interfaces to manipulate the remote RTSPServer. 

* <p> 

* ^author -riK. 

* 0 version $Revision: 1.0 $ 

* @see marconi. ras .MarconiServer 

* esince prototype 1.0 
V 

public class RTSPServerControl { 
/* 

* RTSPServer private info. 

"l^rivate final static String obj_narae = "marconi .ras .RTSPServerControl"; 
J^rivate final static int TOR_OFFSET =» 0; 
private final static int M_OFFSET » 4; 
private final static int LM_OFFSET = 8; 
private final static int PATH_OFFSET = 12; 

m 

V** 

^ * The RTSPServer Host . 

L 

■^protected String hostname; 

--^ * The RTSPServer port, 
'^protected int port; 
/* 

* TCP-Client resources for communicating with the RTSPServer. 
*/ 

private Socket rtsp_sock « null; 

private Buf feredlnputStream rtsp_in = null; 

private Buf feredOutputStream rtsp_out = null; 

/** 

* Type of request field value <code>start</code> . 
V 

protected final static byte TOR^START = 1; 

/it It 

* Type of request field value <code>stop</code> . 
*/ 

protected final static byte TOR^STOP = 2; 
/** 

* Type of request field value <code>commercial</code> . 
V 

protected final static byte TOR^COMMERCIAL « 3; 
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/ * ★ 

* Returned status "Wlue <code>ok</code> . 
protected final static byte STATUS_OK - 0; 
^ ★ ★ 

* Returned status value <code>error</code>, 
V 

protected final static byte STATUS_ERR = 1; 
/ * * 

* Returned status value <code>duplicate</code>- 
*/ 

protected final static byte STATUS_DUP = 2; 

/ -kit 

* Returned status value <code>states full</code>. 
*/ 

protected final static byte STATUS_FUL = 3; 

/ -k-k 

* The number of bytes returned by RTSPServer. 
V 

protected final static int RECEIPT_LEN = 1; 
/ * ★ 

* Creates an object that will interface with the RTSPServer. 
*/ 

public RTSPServerControl (String rtsp_h, int rtsp_p) { * 
this. hostname = rtsp_h; ; 
this. port = rtsp_p; 
try { 

this.rtsp_sock = new Socket (rtsp_h, rtsp_p) ; 

this.rtsp_in = new BufferedlnputStream (rtsp_sock.get Input Stream ()) ; 
this.rtsp_out = new Buf feredOutputStream(rtsp_sock.getOutputStream ( ) ) ; 

} 

catch (lOException e) { 
} 

} 

/ ** 

* Signals the RTSPServer to start a new thread to support the specified channel, 
* 

* @param g_maddr global multicast address. 

* Qparam l_maddr local multicast address. 

* Sreturn byte representing the status returned from RTSPServer. 
V 

public byte startChannel (InetAddress global_addr, InetAddress local_addr) { 
byte [ 1 requestPkt ; 
byte [ 1 receiptPkt ; 
int n - 0; 

// compose outgoing packet & send 
requestPkt =■ encode (TOR^S TART, 

global_addr.getAddress {) , 

local_addr.getAddress () , 

null) ; 

try { 

rtsp_out .write (requestPkt, 0, requestPkt . length) ; 

} 

catch (lOException e) ( 

System. err .println (obj_name + ".startChannel: " + e .getMessage () ) ; 
e .print StackTrace ( ) ; 

} 
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// read the status returned by RTSPServer 
receiptPkt = new byte [RECEIPT_LEN] ; 
try { 

n = rtsp_in. read (receiptPkt, 0, RECEIPT„LEN) ; 

} 

catch (lOException e) { 

System, err. println (Ob j_name + " . startChannel : " + e-getMessage {) ) ; 
e-printStacJcTraceO ; 

} 

if (n < RECEIPT^LEN) ( 

System. err. println(obj_name + " . startChannel : returned byte is corrupted. ); 
return (STATUS_ERR) ; 

} 

// return status 
return ( receiptPkt [ 0 ] ) ; 

} 

/** 

* Signals the RTSPServer to stop the specified channel. 
* 

* @param l^maddr local multicast address. 

Q* Qreturn byte representing the status returned from RTSPServer. 

J^ublic byte stopChannel ( InetAddress local_addr) { 
H: byte[] request Pkt; 
byte [ ] receiptPkt ; 

V int n = 0; ^ 
ffi i 
m // compose outgoing packet & send 

requestPkt = encode (TOR_STOP, null, local_addr. get Address 0 , null); 

try { 

,L rtsp_out .write (requestPkt, 0, requestPkt . length) ; 

y > 

catch (lOException e) { 
U= System. err. println (Ob j_name + ".stopChannel: " + e .getMessage () ) ; 

in e.printStackTrace 0 ; 

6 } 

^ // read the status returned by RTSPServer 
receiptPkt = new byte [RECEIPT_LEN] ; 
try { 

n = rtsp_in. read (receiptPkt, 0, RECEIPT_LEN) ; 

} 

catch (lOException e) { 

System, err. println (Ob j_nanie + ".stopChannel: " + e.getMessageO ) ; 
e.printStackTrace 0 ; 

} 

if (n < RECEIPTJLEN) { 

System. err. println (obj_name + ".stopChannel: returned byte is corrupted. ); 

return (STATUS.ERR) ; 

} 



} 



// return status 
return (receiptPkt [0] ) ; 



* Signals the RTSPServer to play the given commercial, 



* 



* Sparam l_maddr local multicast address. 

* eparam path commercial file path. 

* e return byte representing the status returned from RTSPServer. 
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Di^^^ciaKlnetAddress iocal_adcir, S^^^c 



V 

public byte playConi!f[ff ciaKlnetAddress local_addr, S^^ng path) { 
byte[] requestPkt; 
byte[] receiptPkt; 
int n = 0; 

// compose outgoing packet & send 

requestPkt = encode (TOR_COMMERC I AL, null, iocal_addr . getAddress ( ) , path) ; 
try { 

rtsp_out .write (requestPkt, 0, requestPkt . length) ; 

} 

catch (lOException e) { 

System. err .println {obj_name + " .playCommercial : " + e .getMessage ( ) ) ; 
e.printStackTrace () ; 

} 

// read the status returned by RTSPServer 
receiptP.kt = new byte [RECEIPT^LENl ; 
try { 

n = rtsp_in. read (receiptPkt, 0, RECEIPT_LEN) ; 

} 

catch (lOException e) { 

System. err . println (ob j„name 
_ + ".playCommercial: " + e. getMessage ()) ; 

Q e . printStackTrace ( ) ; 

ffi } 

in if (n < RECEIPT_LEN) { 

System. err .println (obj_name 
m + " .playCommerical : returned byte is corrupted."); 

return (STATUS_ERR) ; 

£ } 



// return status 
return ( receiptPkt [ 0 ] ) ; 



} 



/ * * 

* Encodes the input parameters into a TCP packet . 
* 

* @param tor type of request. 

* @param m^addr global multicast address for a station. 

* @param Inuaddr local multicast address for a station. 

* Gparam path commercial file. 

* Greturn the encoded byte array buffer. 
V 

static byte[] encode (int tor, byte(] m^addr, byte[] lnL_addr, String path) { 
int path_len = (tor TOR^COMMERCIAL) ? path. length () : 0; 
byte[] buffer = new byte (PATH_OFF SET + 

((tor == TOR^COMMERCIAL) ? path_len : 1)]; 

// type of request 

buffer [TOR^OFFSET + 0] = (byte) ((tor « 16) »> 24); 
buffer [TOR^OFFSET + 1] = (byte) ((tor « 24) »> 24); 

// path length 

buffer [TOR„OFFSET + 2] = (byte) ( (path_len « 16) »> 24); 
buffer [TORu-OFFSET + 3] « (byte) ( (path_len « 24) »> 24); 

// M: global multicast address 
if (tor ==• 1) { 

System, arraycopy (m^addr, 0, buffer, H_OFFSET, n^_addr. length) ; 

} 

// LM: local multicast address 
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System. arraycopydm.^^ 0, buffer, LhLOFFSET, Inuadd^^ngth) ; 



// commercial file path — 
if (tor == 3) { 

byte[] pathbuf = path.getBytes ( ) ; 

for (int i - 0; i < pathbuf . length; i++) { 
buffer [12 + i] = pathbuf [i]; 

} 

} 

return buffer; 

} 

/* * 

* Decode the status value. 
V 

public static String decodeStatus (byte status) { 

switch (status) { 

case 0: return "OK"; 

case 1: return "ERROR"; 

case 2: return "DUPLICATE"; 

case 3: return "STATES_FULL"; 
_ default: return "UNKNOWN_STATUS=" + status; 

e } 
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/* marconiNet - Internet Rad^^^twork 

* Distributed Internet Radi^^erver (DIRS) : [LAS interface] 
* 

* $<marconi.>LAS. java -vl . 0 (prototype version), 98/8/19. 

* @jdkl.2, -riK. 
V 

package marconi.ras; 

import j ava . rmi . * ; 
import java. ut il .Vector; 

/ * ★ 

* The LAS (local advertisement server) remote interface provides interfaces 

* for the advertising company, to store and broadcast local commercials. 
*/ 

public interface LAS extends Remote { 

// public int uploadCommercial (byte ( ] file) 
// throws RemoteException; 

// public Vector reviewTimeSlots (int channel) 
// throws RemoteException; 

S Tell the ad server to reserve a slot. 

^/ 

y?/ public boolean buyCommercialTime (int channel. String ad„id) 
i0/ throws RemoteException; 

} m 
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/* marconiNet - Internet Rad^BbtworJc 

* Distributed Radio Antenna^B^ver (RAS) : [RAS Implement at idl^F 
* 

* $<marconi.ras,>MarconiServer, java -v3 • 0 (prototype version), 1998/12/22 $ 

* @jdkl.2, -rxK, 
*/ 

package raarconi.ras; 

import java.rmi.*; 

import java.rmi. server.*; 

import java . rmi . registry , LocateRegistry ; 

import java.net . *; 

import java.util . *; 

import java.io.*; 

import marconi .util . *; 

* The <code>MarconiServer</code> class implements the interfaces <code>RAS</code> 

* (radio antenna server) and <code>LAS</code> (local advertisement server) . 

* As a RAS, it should manage a particular set of multicast channels that are 

* active and allow the IRCs (internet radio clients) to be able to tune to 

* each channel. The LAS server provides an API-like interface to the advertising 

* companies. It also maintains a local database to store the commercials. 

* <p> 

* Author -riK. 

* ^ersion $Revision: 1.0 $ 

* ipiee marconi. ras .Channel 

* i^ince prototype 1.0 

pubt'ic class MarconiServer extends UnicastRemoteObject 

implements RAS, Runnable { // this version does not implement LAS yet... 

Radio Antenna Server local id 

yfinal String name = "marconiNet: RAS, the radio antenna server/MarconiServer"; 
:^final static String obj_narae = "marconi . ras .MarconiServer" ; 
|=^rivate String hostname «■ null; 

S * The hard-coded port number for local RMI registry, 
public final static int RMI_PORT = 5678; 
/** 

* The multicast address used for global announcement of CDP packets. 
*/ 

public final static String GLOBAL^CAP = "225.3.0.0"; 
/*★ 

* The multicast address used for local announcement of CDP packets. 
*/ 

public final static String L0CAl4_CAP = "225.3.0.1"; 
/** 

* The port used for channel announcement protocol (CAP) . 
*/ 

public final static int CAP^PORT = 7777; 
/** 

* The port used for multicast communication between RSC and RASs. 
V 

public final static int RSC^ORT - 8910; 
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^i^lticast communication between^ll^ 



/ ★ * 

* The port used f cJWRulticast communication between^BB and IRCs . 
*/ 

public final static int IRC_PORT = 8910; 
/ * * 

* The default TCP port used for communicating with the RTSPServer. 
V 

public final static int RTSP_PORT = 8765; 
/ * ★ 

* The ttl used for multicast from RSC to RASs. 
*/ 

public final static int GLOBAL_TTL = 128; 
/ ★ * 

* The ttl used for multicast from RAS to IRCs. 
*/ 

public final static int LOCAL^TTL = 16; 
/ ★ * 

* The maximum number of channels that can be supported locally (finite number 

* of channels) . 

n */ 

public final static int MAX_CHANNELS = 20; 

y i / * ★ 

^ * The maximum media content payload length in bytes (=RTP payload length) . 

m */ 

ffl public final static int MAX_PAYLOADLEN = 4096; 

^ / * * 

The maximum RTP header length. 

L */ 

^ public final static int MAX_RTPHDRLEN = 20; 

_L / ★* 

^ * This thread receives channel announcements and maintains the channel 

^ * directory database (analogous to session directory -Sdr) . 

; V 

^ private volatile Thread directoryThread = null; 

/ *★ 

* This thread announces the channel descriptions to the local listeners. 
*/ 

private volatile Thread announcerThread = null; 

* This thread is started along with the <code>directoryThread</code> . It is 

* used to generate the advertisement schedule. 
V 

private volatile Thread advert iseThread = null; 

* RAS channel registry / database. 
V 

private Channel [] channelRegistry ~ null; 
/** 

* Station multicast address (CDP) to channel ID mapping. 
V 

private Hashtable channelMapper = null; 

private final static Integer NOT_SUPPORTED = new Integer (-1); 
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ocol Cache. 



* Channel Announcement 
*/ 

private Hashtable capCache = null; 
/ * * 

* The RTSPServer remote controller. 
*/ 

private RTSPServerControl rtspServer = null; 
/ * ★ 

* The local multicast address dispenser (one instance per RAS) . 
V 

private MaddrDispenser l_maddrRegistry = null; 
/** 

* The local multicast address for local station's content. 
*/ 

private InetAddress l_maddr_local null; 
/** 

* The local station's channel id. 
V 

public final static String LOCALSTA = "LOCAL"; 
^** 

fi* The files containing local station's program announcement. 

^^rivate final static String LOCALSTA__CDP = "_localcdp"; 
yprivate final static String LOCALSTA_SCHED = "_localsched"; 

^ * Time interval between each Marconi process (30 seconds) . 
Iprivate- final static long INTERVAL = 10000; // reduced for demo 
01/** 

y= * Channel Announcement Protocol (CAP) resources. 

~=;private MulticastSocket cap_receiver = null; 
^private MulticastSocket cap_sender = null; 
^private boolean SOCKET 1_IN_USE =- false; 
private boolean S0CKET2_IN_USE = false; 

/* * 

* The RSA public key. 
*/ 

private byte[] publicKey = {(byte) 0x0}; 
/** 

* The RSA private key ♦ 
*/ 

private byte[] privateKey = {(byte) 0x0}; 
/** 

* Instantiate the MarconiServer of RAS (radio antenna server) with its 

* default settings. It also establishes a connection to the RTSPServer. 
*/ 

public MarconiServer (String rtsp_h, int rtsp_p) throws RemoteException ( 
try { 

// ihitialzie 

hostname = InetAddress. getLocalHost () .getHostName () ; 
rtspServer = new RTSPServerControl (rtsp_h, rtsp_p) ; 
channelRegistry = new Channel [MAX_CHANNELS] ; 
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channelMap^^^= new HashtableO; 
capCache ^^Pf HashtableO ; 
cap_sender = new MulticastSocket ( ) ; 
cap_receiver = new MulticastSocket (CAP_PORT) ; 
l_maddrRegistry = new MaddrDispenser () ; 
l_maddr_local = l_ma ddrRegis try .next () ; 

// join CAP multicast group 

cap_receiver . joinGroup (Inet Address .getByName (GLOBAL_CAP) ) ; 

} 

catch (Exception e) { 
} 

start 0 ; 



/ * * 

* Registers a station into a channel slot. These slots are indexed through 

* the channel id's. 
* 

* Gparam c the channel id. 

* @param ma global multicast address used for station broadcast. 

* @return true if the station/channel is successfully registered and false 

* otherwise. 
V 

public synchronized boolean registerChannel (int c, String ma) 
throws RemoteException { 

// if channel is not already taken and its updated cache exists 
if (channelRegistry [c] == null && capCache. containsKey (ma) ) { 

// add new channel to database 
channelMapper .put (ma, new Integer (c) ) ; 
try { 

InetAddress l_maddr = l_maddrRegi s try .next () ; 
channelRegistry [c] - new Channel (c, l_maddr) ; 

} 

catch (MaddrException e) { 
return false; 

} 

// initialize channel from the cache 

ChannelRegistry [c] .read_cdp( (CDPPacket) capCache .get (ma) ) ; 
ChannelRegistry [c] . init (publicKey, privateKey) ; 

// remove new channel from the global cache 
//capCache . remove (ma) ; 

System. out .println 

(obj_name + ".registerChannel: created channel-" + c) ; 

return true; 

} 

// if channel in use 

else { 

System. err .println (obj_name + 

" .register .Channel: cannot create channel-" + c) 

return false; 

} 



* Removes a channel from the database. 

* Qparam c the channel id to be removed. 
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* ereturn true if the ^^ion/channel is successfully r^^^d and false 

* otheCT^ree. 

public synchronized boolean removeChannel (int c) 
throws RemoteException { 
// if the channel exists 
if (channelRegistry [c] != null) { 

// stop the channel thread and free resource 
if (channelRegistry [c] .isOnline 0 ) { 
ChannelRegistry [c] .destroyO; 

l_maddrRegistry. remove (channelRegistry [c] .l_maddr) ; 
// remove channel from database 

channelMapper .put (channelRegistry [c] .g.maddr.getHost Address () , 

NOT_SUPPORTED) ; 
channelRegistry [c] = null; 

System. out .println (obj_name + ".removeChannel: removed channel-" + c 
return true; 

} 

// if the channel doesn't exist 

else { 

Q System. err .println (obj_name + 

'.^ " .remove. Channel: cannot remove channel-" + c) ; 

\p return false; 

J } 

s 

I* 

y=* Gdeprecated replace by RTCP signaling. 

J * This class does not actually implement the audio playing mechanism. It 
= * Return the status of this request. This method is merely used as means 
y * of finding out who's listening to what. The next version should replace 

* this module with a more scalable approach such as by utilizing the 

H * RTCP signals. Currently, this RMI request is also being used to trigger 

* the actual broadcasting. If the requested channel is broadcasting 
Q * already, nothing else is done. If not, the MarconiServer initiates the 

broadcasting procedures (i.e. start listening to the global multicast 
address and redirecting the stream locally) . 



n 



* Gparam c the channel id. 

* Sreturn true if successful, false otherwise. 
* 

public synchronized boolean playChanneK int c) 
throws RemoteException { 

// if channel exists 

if (ChannelRegistry (cl !« null) { 

//if channel not already started, signal RTSPServer to start it 
ChannelRegistry [c] .HIT_COUNT++; 
if ( ! ChannelRegistry [c] . isOnline ( ) ) { 
try { 

ChannelRegistry [cl . start (); 

System. out. println (Ob j_name + " .playChannel: channel-" + c 

+ " started."); 

} 

// catch TooManyChannelThreadsException 
// & lllegalThreadStateException 
catch (Exception e) { 

System. err .println (obj_name + 
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" .playChannel : ca^^B play channel-" + c) ; 

return false; 

} 

} 

// return the local multicast address of the channel 
return true; 

} 

else { 

System. err .println (obj„name + 

".playChannel: cannot play channel-" + c) ; 

return false; 

} 

} 

V 
/ * ★ 

* Stops all broadcasting channels and terminates this RAS, 
*/ 

public void shutdown () throws RemoteException { 
synchronized (channelRegistry) { 

for (int i = 0; i < MAX_CHANNELS; i++) { 
if (channelRegistry [i] != null) { 
~ reraoveChannel (i) ; 

stopO; 
01 System . exi t ( 0 ) ; 

m ^ 

HI /** 

+ * Starts the MarconiServer . 

L 

LJ public void start () { 

g] directoryThread = new Thread (this) ; 

Q directoryThread. start () ; 

announcerThread = new Thread (this ) ; 

announcerThread . start ( ) ; 
y advertiseThread = new Thread (this) ; 

O advertiseThread . start ( ) ; 

} 

/ ** 

* Stops the MarconiSearver . 
V 

public void stopO { 

directoryThread = null; 
announcerThread » null; 
advertiseThread » null; 

// release sockets and leave announcement group 
try { 

while ( SOCKET 1_IN_USE) { 
Thread. sleep (3) ; 

} 

cap_receiver . leaveGroup ( InetAddress . getByName (GLOBAL_CAP) ) ; 
cap_receiver • close ( ) ; 
cap„sender . close ( ) ; 

catch (Exception e) { 

e.printStackTrace 0 ; 

} 

} 
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* Returns the channel usage statistics. 



* Qreturn an array of channel statistics. The array size is the 

* <code>MAX_CHANNELS</code>. There maybe <code>null</code> entries in the 

* array for the channel slots that are not supported. 
*/ 

public ChannelStatistics [] getStatistics ( ) ( 

ChannelStatistics [] stats = new ChannelStatistics [MAX_CHANNELS] ; 
synchronized (channelRegistry) { 

for (int i = 0; i < MAX_CHANNELS; i++) { 
if (channelRegistry [i] != null) { 

stats [i] - channelRegistry [i] .audit () ; 

} 

} 

} 

return stats; 



* Adds commercial list. 

r=3 * Qparam ad_list an array of <code>String</code>3 that refers to the 

* commercial filenames. 

?y * ^return whether the request was successful. 

yj V 

^4|5ublic boolean submitCommercialList (String [ ] ad„list) { 

01 try { 

m for (int i = 0; i < ad_list . length; i++) { 

^ StringTokenizer st = new StringTokenizer (ad_list [i] ) ; 

% int id = Integer. parseint (St. nextTokenO ) ; 

'"^ ChannelRegistry [id] .addCommercial (st .next Token () ) ; 

L } 

O for (int i = 0; i < MAX^CHANNELS ; i++) { 

p if (channelRegistry [i] null) { 

U channelRegistry [i] .genCommercialFile () ; 

^ return true; 

^ } 

catch (Exception e) { 

System. err. println(obj_name + 

".submitCommercialList: illegal list format"); 

return false; 

} 

} 

/* 

* This <code>run</code> method starts the MarconiServer . 
V 

public void run() { 

// cache update hour 

long hour ~ System. currentTimeMillis () ; 
/* 

* Global directory thread running. 
*/ 

while (Thread. current Thread 0 == directoryThread) { 



* Receive CDP packets and maintain channel database. 
V 
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S0CKET1_IN^^ = true; 
try { 

DatagramPacket recv_pkt = CDPPacket .compose 0 ; 
cap_receiver. receive (recv_pkt) ; 
CDPPacket cdp = new CDPPacket (recv_j5kt) ; 

synchronized (channelRegistry) { 

// create new mapping 

if ( !channelMapper.containsKey (cdp.MADDR) ) { 

channelMapper.put (cdp.MADDR, NOT_SUP PORTED) ; 

} 

// update announcement appropriately 

Integer Id = (Integer) channelMapper .get (cdp.MADDR) ; 
if ( Id. equals (NOT_SUPPORTED) ) { 
capCache.put (cdp.MADDR, cdp) ; 
System, out .println (obj_name + ".run: new cdp cached for " + cdp.MADDR); 

} 

else { 

ChannelRegistry (Id. intValueO ] . read_cdp (cdp) ; 
System. out .println (obj_name + ".run: local channel's cdp cache refreshed"); 

} 

} 

} 

catch (Exception e) { 

e.printStackTrace () ; 

} 

S0CKET1_IN_USE = false; 

// time to refresh cache (daily) 
long current_hour = System. currentTimeMillis () ; 
if (current_hour > hour + Time stamp. DAY) { 
System, out .print In (obj_name + ".run: routine -refresh local cache"); 

ref resh_cache () ; 

hour += Timestamp.DAY; 

} 

/* 

* Interval b/w each loop for receiving global channel directory. 
V 

if (! Thread. interrupt ed() ) { 
try { 

System, out .println (obj_name + ".run: - "); 

Thread . sleep ( INTERVAL) ; 

} 

catch (InterruptedException e) { 
} 

} 

} 

/* 

* Local Directory thread running. 
*/ 

while (Thread, current Thread () ~ announcerThread) { 
/* 

* For each installed local channel send out announcements. 
V 

for (int i = 0; i < MAX_CHANNELS && announcerThread !» null; i++) 
if (channelRegistry [i] == null) { 
continue; 

} 
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CDPPacket loc^Bdp = channelRegistry [i] .writeJ^Po ; 

DatagramPacke^end^kt = local_cdp. compose (LOCJKICAP, CAP_PORT) ; 
try { 

cap_sender.send(send_j3kt, (byte) LOCAL_TTL) ; 

} 

catch (lOException e) { 

System, out .println (obj_name + ".run: 

e .printStackTrace () ; 

} 

// sleep between every announcement (do not flood network) 

try { 

Thread, sleep (5000) ; 

catch (InterruptedException e) { 
i 

) 

/* 

* Announce local track programming. 
*/ 

if (announcerThread !=» null) { 

CDPPacket localsta_cdp = write^cdpO; 

DatagramPacket send^kt = localsta.cdp. compose (LOCAL.CAP, CAP_PORT) ; 
cap_sender.send(send_pkt, (byte) LOCAL_TTL) ; 

^ catch (Exception e) { 

m System. out. println(obj_name + ".run: "); 

m e. printStackTrace 0 ; 

£ 1 

^ /* 

Q * interval b/w each loop for sending local channel directory. 

m */ 

U if (! Thread. interrupted 0 ) { 

Ifi try { 

,~ Thread, sleep (INTERVAL) ; 

Q catch (InterruptedException e) { 

} 

} 

} 

/* 

* Advertise thread running. 
*/ 

while (Thread, current Thread 0 == advert iseThread) ( 

**Dump each channel's commercial queue (list of commercials to play) 

* to a file so that it can be used by the LAIP (local advertisement 

* insertion protocol) . 
*/ 

for (int i « 0; i < MAX^CHANNELS; i++) { 
if (channelRegistry [i] null) { 

channelRegistry [i] .genCommercialFile () ; 

} 

} 

/* 

* Interval b/w each loop for generating commercial files. 
*/ 
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Ld^^^erruptedO ) 



if (iThreac 
try { 

Thread. sleep (Timestamp, DAY / 4); 

} 

catch (InterruptedException e) { 
} 

} 

//Thread.yieldO ; 



/ ★ * 

* Removes old cache entries. 
*/ 

private void ref resh_cache ( ) { 

long current_hour = System. currentTimeMillis () ; 

synchronized (capCache) { 

Enumeration capList = capCache. elements () ; 
while (capList .hasMoreElements 0 ) { 

CDPPacket cdp = (CDPPacket) capList .nextElement () ; 
if (current_hour > cdp. timeStamp + CDPPacket , TTL) { 
capCache. remove (cdp.MADDR) ; 

} 

} 

) 

} 

/•kit * 

* Provides local and global cache of channel announcements for i 

* immediate download (instead of waiting for the periodic announcement) . 
* 

* @param local <code>true</code> if requesting for a local announcement download. 

* ©return list of channel descriptions (CDPPackets) in <code>Vector</code> . 

* @see marconi.util. CDPPacket 
*/ 

public Vector downloadCAP (boolean local) throws RemoteException { 

// return local announcements 
if (local) { 

synchronized (channelRegistry) { 

Vector cdp_list = new Vector ( ) ; 

for (int i = 0; i < MAX_CHANNELS ; i++) { 
if (channelRegistry [i] != null) { 

CDPPacket cdp = channelRegistry [i] .write_cdp () ; 
cdp_list .addElement (cdp) ; 

} 

} 

return cdp.list; 

} 

} 

// return global announcements 
else { 

synchronized (capCache) { 

Vector vec =» new Vector (); 

Enumeration enum = capCache. elements () ; 

while ( enum. hasMoreElements () ) { 

vec . addElement (enum. nextElement () ) ; 

} 

return vec; 

} 

} 
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* Creates a CDP announcement for the local station track, 
* 

* Greturn a channel description of the local track. 

* Qsee marconi .util.CDPPacket 

* / 

private CDPPacket write_cdp() throws AnnouncementException { 
CDPPacket cdp = null; 
BufferedReader f in = null; 
String schedule = 



n n . 



try { 

cdp = new CDPPacket (LOCALSTA_CDP) ; 

fin = new Buff eredReader (new FileReader (LOCALSTA_SCHED) ) ; 

} 

catch (Exception e) { 

throw new AnnouncementException 

(obj.name + ".write_cdp: the local schedule file cannot be opened. ); 

} 

while (fin != null) { 
String line = null; 
try { 

_ if ((line = f in.readLine () ) == null) { 

0 fin. close 0 ; 
\D break; 

in } 
^ } 

01 catch (lOException e) { ^ 

break; i 

^ if (line. length 0 > 0) { 
+= String program = ""; 

^ StringTokenizer st = new StringTokenizer (line) ; 

Q Calendar cal = Calendar .getlnstance () ; 

U try { 

^ for (int i = 0; i < 2; i++) { , 

m cal. set (Calendar. DAY_OF_WEEK, Integer .parseint (st .nextTokenO ) ) ; 

□ cal. set (Calendar. HOUR^OF.DAY, integer .parseint (st.nextToken {) ) ) ; 

O cal. set (Calendar. MINUTE, Integer .parseint (st .nextToken () ) ) ; 

cal . set (Calendar . SECOND, Integer . parseint (st . nextToken () ) ) ; 

program string. valueOf (cal.getTime () .getTime () ) + "1"; 

} 

program += st.nextToken () + "I-"; 

schedule += (schedule. length () > 0) ?",":"" + program; 

} 

catch (Exception e) { 

throw new AnnouncementException 

(obj_name + ".write_cdp: invalid local schedule file."); 

} 

} 

} 

cdp. id = LOCALSTA; 

cdp. date = Timestamp.get_midnight () ; 

cdp.MADDR = this.l_maddr_local.getHostAddress 0 ; 

cdp.MPORT = this.IRC_PORT; 

cdp.MTTL ^ this.LOCAL_TTL; 

cdp. schedule =» schedule; 

return cdp; 
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* The main method ^^butes the server setup process^ 
*/ 

public static void main(String args[]) throws RemoteException { 

// check arguments (rtsp server) 
if (args. length != 2) { 

System.err. print In ("usage: \n" 

+ "MarconiServer <RTSP hostname> <RTSP port>"); 

System. exit (-1) ; 

} 

System. setErr (System. out) ; 
// install a security manager 

System. set SecurityManager (new RMISecurityManager () ) ; 

// setup and start the server on local host 
try { 

LocateRegistry . createRegistry (RMI_PORT) ; 

MarconiServer marconiServer = new MarconiServer (args [0] , 

Integer .parseint (args [1] ) ) ; 
Naming, rebind ("//:" + RMI_PORT + + obj_name, marconiServer); 
System. out .print In (marconiServer .hostname 

+ " bound in registry at port " + RMI_PORT) ; 

} 

O catch (Exception e) { 

System. err. println (obj_name + ".main: " + e.getMessage () ) ; 
e.printStackXrace () ; 

} 
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la^rerver (RAS) : [IRC GUI Controls 



/* marconiNet - Internet Rac^^, 

* Distributed Radio Antenna^frver (RAS) : [IRC GUI Controls] 
* 

* $<marconi. ire. >IRCControls . java -v2 . 0 (prototype version), 1999/02/15 $ 

* @jdkl,2, -riK. 
*/ 

package marconi . ire- 
import java.awt . *; 
import java.awt .event 
import java . util . * ; 
import java.net.*; 
import java.io.*; 

f -k-k 

* This panel contains user interfaces to the applet. 
*/ 

public class IRCControls extends Panel { 
public static TextField entry_l; 
private static int WIDTH = 600; 
private static int HEIGHT « lOOj 

/ * * 

* Instantiates the control panel. 

a V 

tTpublic IRCControls 0 { 

if! GridBagLayout grid = new GridBagLayout ( ) ; 

GridBagConstraints cons = new GridBagConstraints () ; 
^ setLayout (grid) ; 

5: cons, fill GridBagConstraints. NONE; 
W cons.weightx = 0.0; 

.rti 

II selected station (id + name) 
entry_l » new TextField (40) ; 
grid.setConstraints (entry_l, cons); 
entry_l.setForeground (Color. yellow. darker 0 ) ; 
ent ry_l.setBackground (Color. blue. darker 0 .darker () ) ; 
add(entry_l) ; 
validate 0; 

// resize 

setSize (WIDTH, HEIGHT) ; 
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/* marconiNet - Internet Rad^^Pbtwork 

* Distributed Radio Antenna ^rver (RAS) : [IRC Directory Con^Wls] 
* 

* $<marconi.ras.>IRCDirectory. java -v2 , 0 (prototype version), 1999/04/20 $ 

* 0jdkl.2, -riK. 
V 

package marconi.irc; 

import java.awt.*; 
import java . awt . event . * ; 
import java . util .Hashtable; 
import java.net,*; 
import java.io.*; 

import marconi . ras . MarconiServer ; 
import marconi. ut il .CDPPacket; 

/** 

* This panel contains user interfaces to the applet. 
V 

public class IRCDirectory extends Panel 
implements Runnable { 

/ -k-k 

— * This thread updates the announcements for the locally supported channels. 
G ★ / 

%)rivate Thread updateThread = null; 
L^rivate static long L_UPDATE = 7500; 

gpublic static IRCUsrApplet owner; 
public static Label label_l; 
public static List directoryList_l; 
Hj^rivate static int WIDTH = 600; 
+private static int HEIGHT = 400; 

Q/** 

m * Instantiates the directory display panel. 

U */ 

'^public IRCDirectory (IRCUsrApplet main) { 

owner = main; 
O GridBagLayout grid = new GridBagLayout () ; 
D GridBagConstraints cons = new GridBagConstraints () ; 

setLayout (grid) ; 

cons .fill = GridBagConstraints .NONE; 
cons.weightx = 1.0; 



// label 1 
cons.weightx = 1*0; 

cons .gridwidth - GridBagConstraints .REMAINDER; 
label_l = new Label {) ; 

label_l.setText ("Local Channel Directory"); 
grid.setConstraints (label_l, cons) ; 
label_l . setForeground (Color . white ) ; 
add(label_l) ; 
validate 0 ; 



// list 1 - global 

cons, gridwidth = GridBagConstraints .REMAINDER; 
directoryList_l = new List (20, false); 

directoryList_l.addActionListener (IRCActionHandler.listControl) ; 
grid.setConstraints (directoryList_l, cons) ; 
directoryList_l .setForeground (Color. yellow. brighter 0 ) ; 
direct oryList_l . setBackground (Color . darkGray ) ; 
add(directoryList_l) ; 
validate 0 ; 
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// resize 

setSize (WIDTH, HEIGHT); 
start 0 ; 



/ * * 

* Starts the directory update. 
V 

public void start () { 

updateThread = new Thread (this) ; 
updat eThread , start ( ) ; 

} 

/** ■ 

* The run methods for the two threads. 
V 

public void run() { 

// local directory 

while (Thread. currentThreadO == updateThread) { 
try { 

Thread. sleep (L_UP DATE) ; 

Hashtable cdp_lookup = owner .getCache () ; 

if (direct oryList_l .get ItemCount () > 0) { 
directoryList_l . removeAll ( ) ; 

} 

for (int i = 0; i < owner .MAX_CHANNELS; i++) { ^ 
String Id = String .valueOf (i) ; r 
if (cdp_loo)cup.containsKey (Id) ) { 

CDPPacket cdp = (CDPPacket) cdp_lookup.get (Id) ; 
directoryList_l .add(cdp.id + " " + cdp. name. 

Integer .parseint (cdp. id) ) ; 

} 

else { 

directoryList_l , add ( Id) ; 

} 

} 

if (cdp_lookup.containsKey (MarconiServer.LOCALSTA) ) { 

CDPPacket cdp = (CDPPacket) cdp_lookup.get (MarconiServer .LOCALSTA) 
directoryList_l. add (cdp. name) ; 

} 

} 

catch (Exception e) { 

System . err . print In ( "marconi . ire . IKCDirectory . run : " ) ; 
e .printStackTrace ( ) ; 

} 

} 

} 

} 
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/* marconiNet - Internet Rad^^Betwork 

* Distributed Radio Antenna^^ver (RAS) : [IRC User Applet) 
* 

* $<marconi.irc.>IRCUsrApplet. java -v2 , 0 (prototype version), 1999/04/20 $ 

* @jdkl.2, -riK. 
V 

package marconi . ire; 

import java . applet • *; 

import java . awt . * ; 

import java.util.*; 

import java.net.*; 

/ / import j ava . rmi . * ; 

//import java. rmi. server.*; 

import marconi .util . *; 

import marconi.util.rtsp.IRC; 

import marconi .ras .RAS; 

import marconi .ras .MarconiServer; 

/** 

* This applet is used by an IRC user. 
* 

* @author -riK. 

* ^version $Revision: 1.0 $ 

* |4see marconi. ras .MarconiServer 

* ifsince prototype vl.O 

puMlic class IRCUsrApplet extends Applet 

\Oimplements java. io. Serializable, Runnable { 

W 

ffl/** 

^ * Session Announcement Protocol (SAP) resources. 

^ * Interfaced via. Channel Directory/Description Protocol (CDP) . 

^= */ 

^ private MulticastSocket cap_receiver = null; 
O protected Hashtable capCache = null; 

m 

l-S. /* * 

^ * This thread updates the announcements for the locally supported channels, 

^private Thread directoryThread = null; 
□ private static long L_UPDATE = 10000; 

// miscellaneious variables 
private static int width = 0; 
private static int height = 0; 
//protected RAS rasServer = null; 
protected int MAX«CHANNELS " 20; 

final static String obj_name = "marconi. ras. IRCUsrApplet"; 
// tools 

IRCDirectory directory - null; 
IRCControls controls « null; 
IRC listener = null; 

/** 

* Initialize the applet and setup display area. 
*/ 

public void initO { 
try { 

width = Integer. parseint (getParameter ("APPLWIDTH") ) ; 
height = Integer .parseint (getParameter ("APPLHEIGHT") ) ; 



// lookup RAS (MarconiServer) 
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//URL URLb^B:^ getDocumentBaseO ; 

//System. ou^^rintln(obj_name + ",init: loca^Bg server"); 
//rasServer = (RAS) Naming* lookup ("//" + getParameter ("RASHost " ) 
// + ":" + getParameter ("RASPort") 

// + "/marconi.ras.MarconiServer") ; 

// init variables 

//MAX_CHANNELS = rasServer • getMaxChannels 0 ; 
capCache = new HashtableO; 

} 

catch (Exception e) { 
// fatal error 

System. err .println(obj_name + ".init: 
e . printSt ackTrace ( ) ; 

} 

// join CAP multicast group 
try { 

cap_receiver = new Mult icast Socket (MarconiServer .CAP_PORT) ; 
cap_receiver. joinGroup ( InetAddress .getByName (MarconiServer .LOCAL_CAP) ) 

} 

catch (Exception e) { 

System, out .println (obj_name + ".init:"); 
e . printSt ackTrace ( ) ; 

} 



// draw display area 
setupDisplay {) ; 



// start 

listener = new IRCO; 
directoryThread = new Thread (this) ; 
direct oryThread . start ( ) ; 



* Display the applet. 
*/ 

public void setupDisplay () { 

setBackground (Color .black) ; 

directory = new IRCDirectory (this) ; 
controls = new IRCControls ( ) ; 
GridBagLayout grid = new GridBagLayout ( ) ; 
GridBagConstraints cons = new GridBagConstraints () ; 

// setup grid 

int rowHeightsd - {400, 100}; 
grid.rowHeights = rowHeights; 
setLayout (grid) ; 

cons. fill ■ GridBagConstraints .BOTH; 
// add directory lists 

cons.gridwidth = GridBagConstraints .REMAINDER; 
cons.weightx = 1.0; 
cons.gridheight = 1; 

grid . setConst raint s (directory, cons ) ; 
add (directory) ; 
validate 0 ; 

// add controls 

cons.gridwidth = GridBagConstraints .REMAINDER; 
cons.weightx « 1.0; 
cons.gridheight - 1; 
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grid. setConstraints (<^^ko1s, cons) ; 
add (controls) ; 
validate 0 ; 

resize (width, height) ; 

) 

/ * * 

* Free resources when closing applet. 
V 

public void destroy 0 { 

// release sockets and leave announcement group 

try { ^ ^ 

cap_receiver.leaveGroup ( met Address. getByName (MarconiServer .LOCAL_CAP) ) ; 

cap_receiver .close 0 ; 

} 

catch (Exception e) { 

e.printStackTrace 0 ; 

} 

stopChannel () ; 
directoryThread = null; 

//try { 

/ / rasServer . terminate ( ) ; 

o //} 

ifi //catch (RemoteException e) { 
// e.printStackTrace 0 ; 

//} 



remove (directory) ; 
remove (controls) ; 



m 

* Run method. 

U V 

y^)ublic void run() { 

•■J ; 

\0 // cache update hour 

g long hour = System. currentTimeMillis () ; 

/* 

* Global directory thread running. 
V 

while (Thread.currentThreadO == directoryThread) { 
/* 

* Receive CDP packets and maintain channel database, 
V 

try { 

DatagramPacket recv_pkt = CDPPacket. compose () ; 
cap_receiver .receive (recv_pkt) ; 

CDPPacket cdp = new CDPPacket (recv_pkt) ; 
System.out.println(obj_name + ".run: cdp parsed"); 

// update announcement appropriately 
if ( ! capCache , containsKey (cdp . id) ) { 
capCache.put (cdp.id, cdp); 

System. out. println(obj_name + ".run: new cdp cached for channel-' 

+ cdp. id) ; 

} 

} 

catch (Exception e) { 
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e . pr int^^:kTrace ( ) ; 

// time to refresh cache (daily) 

long current_hour = System,currentTimeMillis () ; 

if (current_hour > hour + Time stamp .DAY) { 

System. out .println (obj_name + ".run: routine -refreshing directory cache."); 

refresh_cache() ; 

hour += Timestamp.DAY; 

} 

/* 

* Interval b/w each loop for receiving local channel directory. 
*/ 

try { 

Thread. sleep (L_UPDATE) ; 

} 

catch (InterruptedException e) { 
} 

} 

} 

/★ * 

* Removes old cache entries. 

o */ 

^ protected void ref resh_cache ( ) { 

long current_hour - System. currentTimeMillis () ; 

synchronized (capCache) { * 
ff^ Enumeration capList = capCache. elements () ; j 

ffl while (capList .hasMoreElements () ) { 

m CDPPacket cdp = (CDPPacket) capList .nextElement () ; 

^ if (current_hour > cdp. timeStamp + CDPPacket .TTL) { 

^ capCache . remove ( cdp . id) ; 

L . } 

y } 



* Inform server that the specified channel is being listen to. This 

* RMI based triggering is very inefficient and not scalable. So 

* alternate approach based on RTCP should replace this. 
V 

public boolean playChannel (int id) { 
boolean status = false; 

if ( capCache. containsKey( St ring. valueOf (id) ) ) { 

CDPPacket cdp = (CDPPacket) capCache . get (String. valueOf (id) ) ; 
try { 

// kill previous thread if running 

listener . st op ( ) ; 

/* 

* The below statement is commented out because the listener 

* is now capable of sending RTCP signals for triggering. 

status = rasServer .playChannel (id) ; 
*/ 

status = true; // replace above 
listener. start (cdp.MADDR, cdp.MPORT) ; 

} 

catch (Exception e) { 

e. print St ackTraceO ; 
return false; 
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) 

return status; 




} 

else { 

return false; 

} 

} 

/ ★* 

* Stops listening to whatever is playing, 
*/ 

public void stopChannel () { 
listener. stop () ; 

} 

/ ★ * 

* Returns the current state of the local channel announcement cache. 
*/ 

protected synchronized Hashtable getCacheO { 
return capCache; 

} 

/** 

_ * Return applet information. 

O V 

iOpublic String getAppletInf o ( ) { 
Ijl return "IRC listener tool"; 
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/* marconiNet - Internet Ra 
* Distributed Radio Antenna 



ic^^Betwork 

la^Wrver (RAS) : [IRC Action Handle^r 



* $<marconi,irc.>IRCActionHandler . java -v2 . 0 (prototype version), 1999/04/21 $ 

* @jd)cl.2, -riK, 
V 

package marconi . ire; 



import java.awt.*; 

import java.awt .event . *; 

import java.util,*; r.v 

import java.io.*; 



/** 

* This class handles actions taken by IRC user. 
V 

public class IRCActionHandler { 

public static ActionListener listControl = new ActionListener ( ) { 
public void actionPerf ormed (ActionEvent e) { 
IRCControls .entry_l . setText 

( IRCDirect ory . directoryList„l . get Item 
(IRCDirectory .directoryList_l .getSelectedlndexO ) ) ; 
String textfield = IRCControls .entry_l .getText ( ) ; 
_ StringTokenizer dir = new StringTokenizer (textfield, " "); 

O int id = Integer .parseint (dir .nextToken 0 ) ; 

'■iQ if (iRCDirectory .owner .playChannel (id) ) { 

Iff System, out .print In ( "marconi . ire . IRCActionHandler" + 

" .actionPerf ormed: playing channel " 
^ + id + ".") ; 

^ else { 

IRCDirectory .owner. stopChannel 0 ; 
^ System. err . print In ( "marconi . ire . IRCActionHandler" + 

, " .actionPerf ormed: error listening."); 
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/* marconiNet - Internet Rad^^Betwork 

* Distributed Radio Antenna ^Wrver (RAS) : [CDP Announcer] 
* 

* $<marconi.ras.>Announcer. java -v2 . 0 (prototype version), 1999/04/12 $ 

* @jdkl.2, -riK. 
V 

package marconi . rsc; 

import java.net.*; 

import java.util . *; 

import java.io.*; 

import marconi. ras .MarconiServer; 

import marconi . util . *; 

/ * ★ 

* The <code>Announcer</code> makes periodic announcements via, CDP (SAP/SDP) . 

* <p> 

* Qauthor -riK. 

* @ version $Revision: 1.0 $ 

* @see marconi. util.CDPPacket 

* @since prototype 1.0 
V 

public class Announcer implements Runnable { 

final static String obj_name = "marconi . rsc .Announcer" ; 
■^tring hostname - 

3 f / * * 

* This thread announces the channel descriptions to the local listeners, 
yjjrivate volatile Thread announcerThread = null; 

S/** 

^ * Time interval between each Marconi process (30 seconds) . 
—private final static long INTERVAL = 30000; 

ffl/** 

H * Channel Announcement Protocol (CAP) resources. 

■^f^ */ 

Qprivate MulticastSocket cap_sender null; 
^private String file = ""; 
/** 

* Constructor. 
*/ 

public Announcer (String file) { 
try { 

hostname = InetAddress.getLocalHost () .getHostName {) ; 
cap_sender »* new MulticastSocket () ; 

} 

catch (Exception e) { 
} 

this. file = file; 
start 0 ; 

} 

★ 

* Starts the Announcer. 
V 

public void start () { 

announcerThread = new Thread (this) ; 
announcerThread. start () ; 

} 
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/★ * 

* Stops the Announcer. 
V 

public void stopO { 

announcerThread = null; 

// release sockets and leave announcement group 
try { 

cap_sender . close ( ) ; 

} 

catch (Exception e) { 

e . print StackTrace ( ) ; 

} 

} 

/ * * 

* This <code>run</code> method starts the Announcer. 
V 

public void run() { 
/* 

* Announcer thread running. 
*/ 

while (Thread.currentThreadO == announcerThread) { 
/* 

* Send out each announcement. 
V 

CDPPacket cdp = null; 
try { 

cdp = new CDPPacket (file) ; 

} 

catch (AnnouncementException e) { 
e . print St ackTrace ( ) ; 

} 

DatagramPacket send_pkt = cdp. compose (MarconiServer.GLOBAL_CAP, 

MarconiServer .CAP_PORT) ; 

if (cdp. id != null) { 
try { 

cap_sender.send(send_pkt, (byte) MarconiServer .GLOBAL_TTL) ; 

} 

catch (lOException e) { 

System. out .println (obj_name + ".run: "); 
e.printStackTrace 0 ; 

} 

System. out .println(obj_name + ".run: announcement sent to " 

+ MarconiServer .GLOBAL_CAP + 
+ MarconiServer • CAP_PORT) ; 

/* 

* Interval b/w each loop for sending local channel directory. 
*/ 

try { 

Thread. sleep (INTERVAL) ; 

} 

catch (InterruptedException e) { 
} 
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^^^he server setup process. 



/* 

* The main method execute^^he server setup process. 
*/ 

public static void main (String args[]) { 
// check arguments (rtsp server) 
if (args. length != 1) { 

System. err. println ("usage: \n" + "Announcer <CDP file>"); 
System.exit (1) ; 

} 

System. setErr (System. out) ; 

// Setup and start the server on local host 
Announcer announcer = new Announcer (args [0] ) ; 

} 
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/* marconiNet - Internet Rad^^etwork 

* Distributed Radio Antenna^^ver (RAS) : [RSC Interface) 

it 

* $<marconi.ras,>RSC. java -v2 . 0 (prototype version), 1999/05/14 $ 

* 0jdkl.2, -riK. 
V 

package marconi . rsc; 

import java.rmi.*; 
import j ava.util. Vector ; 

/** 

* The <code>RSC</code> RMI interface provides security/payment APIs for RAS. 

* <p> 
* 

* @author -riK. 

* @version $Revision: 1.0 $ 

* Ssince prototype vl,0 
V 

public interface RSC extends Remote { 
* 

* Accept RAS' public key and include this RAS for SEK distribution, 

* $enroll (byte[] publicKey) $ 

o 

■public int enroll (byte [ ] pubkey) 
throws RemoteException; 
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/* marconiNet - Internet Raq 
* Distributed Radio Antenna 



[Channel Descript 




Class] 



* $<marconi.ras.>CDPPacket . java -v4 • 0 (prototype version), 1999/05/05 $ 

* @jdkl,2, --riK. 
*/ 

package marconi.util; 

import java.io.*; 

import java.riet.*; 

import java.util-StringTokenizer; 

import marconi .util . sd. *; 

/** 

* This class encapsulates and parses the Channel Description Protocol (COP) 

* Packet, It acts as an transparent interface to the SAP/SDP protocol (the 

* utilization of protocols SAP/SDP is hidden from the users of CDP) . 

* <p> 

* Included in the packet are a subset of the following fields in any order: 

* <ul> 

* <li>name 

* <li>category 

* <li>description 

* <li>origin 

* f^i> language 

* /lli>id 

* }^li>maddr 

* ^■li>mport 
*^li>mttl 

* Pli>seklist 
*gli>date* 
*:p<li>schedule* 
*''^/ul> 

*lThe channel description can be created from a file or any other object that 
*Q;an be converted to a text stream. The format is given below. 

*r<p> 

*j=j;ach field is to be contained in a line. Each line is to start with the field 
*:Vname followed by ' ^' , and then the field value (i.e. "category«news") . 
*^<p> 

*yrhe fields marked * are optional if the CDP packet is not being used to announce 
^^rogram schedules. If the CDP packet is used for program schedule announcement, 

* all the fields must be specified. (Note: the current version only allows one-day 

* scheduling per an annpuncement , Multiple CDP packets should be used to schedule 

* for different dates) There is no version number, nor is there a session id. A new 

* announcement can simply replace the previously received ones. The different 

* announcements are distinguished by examining the multicast address and the date. 

* If one wishes to schedule ahead of time, the date field should be used to indicate 

* to which date the schedule field is assigned. 

* <p> 

* The <code>schedule</code> field should be in the following format: 

* <p><blockquote><pre> 

* schedule=<programl> , &lt ;program2&gt ; , < program3&gt ; , . . .etc. 

* </pre></blockquote> 

* <p> 

* separating each sub-field with a comma (',')• 

* <p> 

* The <code>date</code> field is represented by specifying the number of 

* milliseconds since the standard base time known as "the epoch", namely 

* January 1, 1970, 00:00:00 GMT. GMT (Greenwich Mean Time) is the Internet 

* conventional reference time zone and it is synchronized with the UTC 

* (Coordinated Universal Time) milliseconds. The receivers of this packet can 

* convert this to the appropriate local time. The data type long (64-bit integer 

* in Java) stores these milliseconds. Note that SDP uses the Network Time Protocol 
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* (NTP) timestamps anj^^b essentially converts UTC to 

* <p> 

* Each program is constructed as: 

* <p><blockquote><pre> 

* <start-time4gt; I & It ; end-time > | ilt ;program-title> | &lt ; description&gt 

* </pre></blockquote> 

* <p> 

* separating each sub-field with a vertical line CI'). Again, UTC milliseconds 

* should be used to specify the times. 

* <p> 

* Lastly, the seklist is the concatenated list of the radio station's session 

* encryption key (SEK) , each time encrypted with the public key that belongs to 

* different RASs (if global announcement) or IRCs (if local announcement) . The 

* encrypted values in binary are PEM-encoded and the delimiter ' |' is used to 

* separate them. Currently CDPPacket is implemented to support RC4 stream cipher; 

* it is a symmetric encryption algorithm with variable key size and fast performance 

* in software. Another nice feature about it is that it is fairly exportable from US, 

* which is necessary for global usage of MaroniNet. 

* <p> 

* It is necessary that all fields be included (except for the optional ones) , although 

* it is not required to have them in order. 

* <p> 

* @author -riK. 

* Gversion $Revision: 1.0 $ 

* @see marconi.util .AnnouncementException 

* @see marconi.util .Timestamp 

* Gsince prototype vl.O 

*/ ' 
public class CDPPacket implements Serializable { i 
final static String obj_name = "marconi . ras .CDPPacket"; 

^** 

* The station name. 
*/ 

public String name - null; 
/★* 

* The content category {music I news I sports I . 
*/ 

public String category « null; 
/ ★* 

* The content description. 
*/ 

public String description - null; 
/*★ 

* The origin of the content (regional ID) . 
*/ 

public String origin = null; 
/★* 

* The language of choice. 
*/ 

public String language = null; 
/★* 

* The multicast address. 
V 

public String MADDR = null; 



* The multicast port. 
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public int MPORT =» 8888; 




* The multicast ttl (set to local scope by default) • 
V 

public int MTTL = 16; 
/** 

* The array of PEM-encoded (base64) session encryption keys. 
*/ 

public String [] SEKLIST = null; 
/ * ★ 

* The channel id. Must be the local hostname if used for global 

* announcement . 
*/ 

public String id = null; 
/ * * 

* The date being scheduled. 
V 

public long date = -1; 

* The radio station's content schedule (list of programs) 
4|j)ublic String schedule = null; 

i: * The date and time of the packet created. 
W */ 

+=public long timeStamp = -1; 

O/** 

fn * The life time of CDP packets (expiration time) . 
;'^public final static long TTL = Time stamp. DAY; 
O /** 

Q * The maximum CDP packet buffer length (currently 4K bytes) . 
*/ 

public final static int MAX_BUFLEN =4096; 
/ * * 

* Raw data containing: the byte-array representation of the packet, if it has 

* one. 
*/ 

private byte[] data - null; 
/** 

* Creates an empty CDP packet. 
*/ 

public CDPPacketO { 

this. timeStamp = Timestamp.get_current () ; 

} 

/ ** 

* Creates CDP packet from a (received) datagram. 

* eparam packet the datagram packet that contains CDP. 
*/ 

public CDPPacket (DatagramPacket packet) throws Announcement Except ion { 
parse (packet) ; 
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this . t imeStamp mestamp . get_current ( ) ; 



* Creates a CDP packet from a file. 
* 

* @param file pathname to where the CDP-file is located. 

public CDPPacket (String file) throws AnnouncementException { 
parse (file) ; 

this.timeStamp = Timestamp .get_current () ; 

} 

/ * * 

* Initializes this CDP packet by parsing a datagram (UDP) packet. 
* 

* @param packet a datagram packet. 
*/ 

public void parse (DatagramPacket packet) throws AnnouncementException { 

// get session description 
SAPPacket sap = null? 
SDPPacket sdp = null; 
try { 

sap - new SAPPacket (packet .getData ()) ; 
sdp = new SDPPacket (sap. pay load) ; 

} 

catch (MalformedSDException e) { 

throw new AnnouncementException 

(obj_name + ".parse: the received announcement cannot be parsed.") 

} 

this. name = sdp. name; 

this. description = sdp. info; 

for (int i = 0; i < sdp, attribute. length; i++) { 
String attr = sdp.attribute [i] ; 
. if (attr null) ( 
continue; 

} 

if {attr.startsWith("lang:") ) ( 

this. language = attr.substring(attr.indexOf (' :' ) + l).trira(); 

} 

else if (attr.startsWith("cat:") ) ( 

this. category = attr. substring (attr. indexOf (':' ) + l).trim(); 

} 

else if (attr.startsWith("X-orig:") ) { 

this. origin » attr . substring (attr . indexOf (':' ) + l).trim(); 

} 

else if (attr. start sWith ("X-seklist :") ) ( 
Vectcr2 seklist « new Vector2(); 
StringTokenizer st ~ new StringTokenizer 

(attr. substring(attr. indexOf (':' ) + l).trim(), "1"); 
while (st .hasMoreTokens () ) { 

seklist . addElement ( st . nextToken ( ) . trim ( ) ) ; 

} 

this. SEKLIST = seklist .toStringArray () ; 

} 

else if (attr. start sWith ( "X-date :") ) { 

String date_str = attr . substring (attr . indexOf (':' ) + l).trira(); 
this. date Long.parseLong (date_str) ; 

} 

else if (attr.startsWithCX-sched:") ) ( 

this. schedule - att r. substring (attr. indexOf (':' ) + l).trim(); 

} 
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inWr: ion. address; 



} 

this.MADDR = sdp.coni?? 
this.MTTL = Integer ,parselnt (sdp . connection . ttl) ; 
this.MPORT = Integer. parseint (sdp. media [0] .getPort 0 ) ; 
this. id = sdp. origin. session_id; 

} 

/** 

* Initializes this CDP packet by parsing from a file. 

* Gparam file_path name and path of the CDP announcement file. 
*/ 

public void parse (String file_path) throws Announcement Except ion { 
/* 

* Open file. 
*/ 

File file = new File (f ile_path) ; 
Buf feredReader file_in = null; 
try { 

file_in = new Buf feredReader (new FileReader (f ile) ) ; 

} 

catch (FileNotFoundException e) { 
throw new AnnouncementException 
O {obj_name + ".parse: the CDP file cannot be opened."); 

\0 } 

m 
m 



/* 

* Read-in the file line by line. 
Ul while (file_in != null) { 



II parse a line 
String line = null; 
try { 

line = f ile_in.readLine () ; 

H catch (lOException e) { 

break; 

O } 

if (line == null) { // break if eof 

try { 

f ile_in . close ( ) ; 

catch (lOException e) { 
} 

break; 

} 

else if (line,startsWith("name=") ) { 

this. name =■ line . substring (line . indexOf ('=' ) + l),trim(); 

} 

else if (line.startsWith("category=") ) { 

this. category = line. substring (line. indexOf ('=»' ) + l).trim(); 

} 

else if (line.startsWith("description=") ) { 

this. description = line . substring (line . indexOf ) + l).trim(); 

} 

else if (line.startsWithCorigin^") ) { 

this. origin = line.substringdine.indexOf ('=' ) + l).trira(); 

} 

else if {line.startsWith("language=") ) { 

this. language = line.substringdine.indexOf ('=' ) + D.trimO; 

} 

else if (line • start sWith ( "maddr='' ) ) { 
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this.M^^^^= line. substring( line. indexO^^j^) + D.trimO; 

else if (line.startsWith("mport=") ) { 

String port_str = line . substring (line . indexOf ('=' ) + l).trim(); 
this.MPORT = Integer .parseint (port_str) ; 

} 

else if (line.startsWith("mttl=") ) { 

String ttl_str = line . substring (line . indexOf ('=' ) + D.trimO; 
this.MTTL = Integer. parseint (ttl_str) ; 

} 

else if (line.startsWith("id=") ) { 

this. id = line. substringdine. indexOf ('=' ) ■♦■ D.trimO; 

} 

else if (line.startsWithCseklist*") ) { 
Vector2 seklist = new Vector2(); 
StringTokenizer st = new StringTokenizer 

(line.substringdine.indexOf ('=' ) + D.trimO, "1"); 
while (st .hasMoreTokens O ) { 

seklist . addElement (st . nextXoken () .trimO ) ; 

} 

this. SEKLIST = seklist .toStringArray 0 ; 

} 

else if (line.startsWith("date=") ) { 

String date_str = line . substring (line . indexOf ('=' ) + l).trimO; 
this. date - Long .par seLong (date_str) ; 

} 

else if (line,startsWith("schedule=") ) { 

this, schedule = line, substring (line. indexOf ('=' ) + D.trimO; 

} 

else { 
/* 

* Uncomment below if you want strict formating of the files. 
*/ 

throw new AnnouncementException 

(obj_name + ".parse: the CDP file cannot be parsed"); 



} 



/** 

* Composes a datagram packet that represents this CDP packet going out to the 

* specified address and port number. This packet is UDP encapsulated SAP/SDP 

* session announcemnet protocol. All appropriate fields, not defined as 

* <code>null</code>, are used to make up this packet. 
* 

* @param addr destination address string. 

* @param port destination port number. 

* @return a datagram packet consisting of the valid CDP (SAP/SDP) fields. 
*/ 

public DatagramPacket compose (String addr_str, int port) { 
Vector2 ten^_vec » new Vector2(); 
SAPPacket sap - new SAPPacketO; 
SDPPacket sdp » new SDPPacket () ; 

/* 

* compose sdp 
V 

// o 

sdp.origin.username = "cdp"; 
sdp. origin. session_id = id; 

sdp. origin. version = String. valueOf (Timestamp.get_current O ) ; 
sdp. origin. network_type = "IN"; 
sdp. origin. address_type "IP4"; 
try { 



in 
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sdp . origin . addre^^ InetAddress . getLocalHost ( ) . g^^^tAddress ( ) ; 

catch (UnknownHostException e) { 
) 

// s 

if (name null) { 
sdp. name - name; 

} 

// i 

if (description != null) { 
sdp. info = description; 

} 

// c 

if (MADDR != null) { 

sdp. connect ion = new SDPConnection ( ) ; 

sdp. connect ion. network_type = "IN"; 

sdp. connect ion. address_type = "IP4"; 

sdp. connect ion. address = MADDR; 

sdp. connection, ttl = String. valueOf (MTTL) ; 

} 

// a 

if (category != null) { 

temp_vec . addElement ( "cat : " + category) ; 

} 

Q if (origin != null) { 

^ temp„vec. addElement ("X-orig: " + origin); 

} 

_ if (language != null) { 

\y t emp_vec. addElement ("lang: " + language); 

ffl } 

m if (SEKLIST != null && SEKLrST[0] != null) { 
m String temp_str = SEKLIST(0]; 

'% for (int i = 1; i < SEKLIST. length; i++) { 

if (SEKLIST [i] != null) { 
L temp_str += T + SEKLIST [i]; 

^ } 

01 ■ } 

y: temp_vec. addElement ("X-seklist:" + temp_str) ; 

in } 

■fi, if (date != -1) { 

temp_vec. addElement ("X-date: " + String. valueOf (date) ) ; 

U } 

if (schedule !=* null) { 

temp_vec. addElement ("X-sched: " + schedule); 

} 

sdp. attribute = temp_vec. toStringArray () ; 
// t -permanent session 
sdp. active = new String [1]; 
sdp. active [01 » "0 0"; 
// ra 

sdp. media [0] - new SDPMedia ("audio". String. valueOf (MPORT) , "RTP/AVP"); 
/* 

* compose sap 
*/ 

sap.message_type = SAPPacket .MT^ANNOUNCE; 
sap. encryption = false; 
sap. compression = false; 
sap.auth_headerlen = 0; 
sap.msgid^hash « 0; 
try { 

sap . source = InetAddress . getLocalHost ( ) . getAddress ( ) ; 

} 

catch (UnknownHostException e) { 
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sap.payload = sop .compose () ; 
this. data = sap. compose () ; 

InetAddress addr = null; 
try { 

addr =■ InetAddress .getByName (addr_str) ; 

} 

catch (UnknownHostException e) { 
} 

return new DatagramPacket (data, data. length, addr, port); 

} 

/ ★ ★ 

* Composes an ascii file that represents this CDP packet. All appropriate 

* fields, not defined as <code>null</code>, are used to make up this 

* packet. 
* 

* @param String filename (path) 
*/ 

public void compose (String filename) { 
File file = new File (filename) ; 
PrintWriter fout = null; 

try ( 

fout = new PrintWriter (new Buf feredWriter (new FileWriter (f ile) ) ) ; 

} 

catch (lOException e) { 
} 

if (name != null) ( 

fout.println("name=" + name); 

} 

if (description != null) { 

fout .print In ("description='' + description); 

} . 

if (category !=» null) { 

fout .print In ("category^" + category); 

} 

if (origin 1= null) { 

fout.println("origin=" + origin); 

} 

if (language !=» null) { 

fout.println("language=" + language) ; 

} 

if (MADDR !« null) { 

f out. print In ("raaddr-" + MADDR); 

} 

if (MPORT !- -1) { 

fout.printlnCmport-" + MPORT); 

} 

if (MTTL !- -1) { 

f out. print In ("mttl=" + MTTL); 

} 

if (id != null) { 

fout . print In ("id=" + id); 

} 

if (SEKLIST != null && SEKLIST[0] null) { 
String temp_str = SEKLIST[0]; 
for (int i = 1; i < SEKLIST . length; i++) { 
if (SEKLIST[i] null) ( 

temp_str += - | + SEKLIST [i]; 

} 

) 
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fout 



if (date -1) { 

fout .println ("date^" + String. valueOf (date) ) ; 



if (schedule != null) ( 

f out .println (''schedule=" + schedule); 



/ * ★ 

* Composes a datagram packet that represents an empty CDP packet. 

* This packet should be instantiated for receiving purposes. It automatically 

* generates a packet with the internal buffer of the maximum length. 



* @return a datagram packet with empty buffer. 
*/ 

public static DatagramPacket compose () { 
byte[] buf = new byte [MAX_BUFLEN] ; 

) return new DatagramPacket (buf , buf. length); 



try 



fout. close () ; 



catch (Exception e) { 
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/* marconiNet - Internet Rad^^etwork 

* Distributed Radio Antenna^Wver (RAS) : [MaddrDispenser ciSW] 
* 

* $<marconi.maddr.>MaddrDispenser. java -vl . 0 (prototype version), 1998/11/11 $ 

* @jdkl.l.7, -riK. 
V 

package marconi .util; 

import java.io.*; 

import j ava . net . * ; 

import j ava. util. Hasht able; 

/** 

* The <code>MaddrDispenser</code> class distributes a domain-wide multicast 

* address for each station, where domain refers to reachability of RAS. Unlike 

* the class <code>MaddrServer</code> it creates multicast channels between RAS 

* and IRCs. Thus, each RAS must include an instance of this object. And 

* assuming a carefully designed domain edges, different instances can utilize 

* the same addresses. 

* <p> 

* We can use administratively scoped address space here, which will eliminate 

* the problem of RAS-coverage (domain) overlaps. But for simplicity and to avoid 

* having to configure the organizational boundary routers, we simply assume 

* for now that there is a local RAS running and use "site-local" scoping 

* iJPv4 TTL=15) . 

* ^> 

* -yj 

* Author "-riK. 

* .Jyersion $Revision: 1.0 $ 

* ^^ee marconi. util. MaddrException 

* Jljsince prototype vl.O 

pul^ic class MaddrDispenser { 

O* Here we use a contiguous address block f;:om the TTL scoped 

S* multicast address spectrum: 

r;* [225.2.0.0 : 225.2.255.255] (site-local iif TTL=15) 

^* Note that it avoids the administratively scoped IPv4 multicast space: 

'i* [239.0.0.0 : 239.255.255.255] 

a*/ 

□ final static int MADDR^LOWBOUND = 0x0000; // [225. 2]. 0.0 

final static int MADDR^UPPERBOUND - OxFFFF; // [225 . 2] . 255 . 255 

final static String MADDR_PREFIX - "225.2"; // 225.0.0.0/16 

final static String RTCP_PREFIX = "225.4"; // 

Hasht able registeredMaddrs » null; 
/ * * 

* Creates a new instance of <code>MaddrDispenser</code> where the next 

* multicast address to be allocated is initialized to the lower bound 

* of the address space. All addresses are recycled. 
*/ 

public MaddrDispenser 0 { 

registeredMaddrs = new HashtableO; 

} 

* 

* Allocates and returns a new multicast address. It will first try to fill-in 

* any holes within its address space. In cither words, it recycles freed 

* addresses. 

* Sreturn the new multicast address. """-^i^., 'V - 

* ^exception MaddrException if it runs out of the given multicast^l^address 



>;''-ir^ ■ 
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* poj 

V 

public synchronized InetAddress nextO throws MaddrException { 

// find an empty multicast address space 
int maddr = MADDR_LOWBOUND ; 
InetAddress inet_maddr = null; 

while (registeredMaddrs. contains (new Integer (maddr ) ) 
++maddr <= mADDR_UPPERBOUND) ; 

// return newly assigned address 
if (maddr <= MADDR_UPPERBOUND) { 
try { 

inet_maddr = InetAddress . getByName (toString (maddr) ) ; 

} 

catch (UnknownHostException e) ( 
e . print StackTrace ( ) ; 

} 

registeredMaddrs. put (inet_maddr, new Integer (maddr) ) ; 
return inet_maddr; 

} 

else { 

throw new MaddrException ( "Multicast address out of bound,"); 

o , ' 

Ui /** 

* Free the address. Return the multicast address back to its pool. 

5 * ' 

^ * @param inet_maddr the address to be freed. t 

public synchronized void remove (InetAddress inet_maddr) ( 
i=P registeredMaddrs . remove (inet_maddr) ; 

a } 

^ /* 

cn ' 

* Construct the full IP address format. 

protected String toString (int addr) { 
p return MADDR^PREFIX + "." + ((addr »> 8) & OxFF) + "." + (addr & OxFF) ; 

* Return RTCP multicast address of the given RTP multicast address. The details 

* of mapping RTP to RTCP address is hidden. 

* @param rtp_jnaddr the RTP multicast address. 
*/ 

public static String rtcp_map (InetAddress rtp_maddr) { 
byte ( ] raw « rtp_maddr . getAddress ( ) ; 

return RTCP_PREFIX + + ((raw [2] « 24) »> 24) + + {(raw [3] « 24) »> 24); 

} 

f-k-k 

* Return IPv4 address as 32bit integer. 
* 

* @parara maddr the inet address to be converted. 
V 

public static int addr_to_int (InetAddress maddr) { 
byte [ ] raw = maddr . getAddress ( ) ; 
int int 32 = raw[0] « 24; 
int32 1= (raw(l] « 24) »> 8; 
int32 I- (raw(2] « 24) »> 16; 
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int32 1= (raw 
return int32; 



int32 1= {raw[3] « ^^^» 24; 
return int32; 



} 

} 
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la^frver (RAS) : [MaddrServer Clas^^ 



/* marconiNet - Internet Rac 

* Distributed Radio Antenna'^ 
* 

* $<marconi.util.>MaddrServer . java -vl . 0 (prototype version), 1998/10/12 $ 

* @jdkl.2, -riK. 
V 

package marconi .util; 

import java.rmi,*; 

import java. rrai. server.*; 

import java . rmi • registry . LocateRegistry ; 

import j ava . io • * ; 

import java.net.*; 

import java . ut il , Hasht able; 

I -kit 

* The <code>MaddrServer</code> class manages the global multicast address 

* allocation to the Radio Station Client (RSC) channels. The current version 

* does not implement distributed approach. Therefore, <code>MaddrServer</code> 

* acts as a centralized server where the RSCs can obtain their multicast 

* addresses via a specific request (RMI request) . 

* <p> 
★ 

* ^author -riK. 

* ^K^ersion $Revision: 1.0 $ 

* yisee marconi. util. MaddrException 
*|j|since prototype 1.0 

puS(ic class MaddrServer extends UnicastRemoteOb ject 
implements MaddrServerlnterf { 

01 final static String obj_name = "marconi .util .MaddrServer"; 

/. / ★ ★ 

* The port number for multicast address. 

S */ 

f; public final static int MADDRSERV_PORT = 8889; 
^ /* 

O * Here we use a contiguous address block from the TTL scoped 

* multicast address spectrum: 

* [225.1.0.0 : 225.1.255,255] (global iff 128 < TTL < 255) 

* Note that it avoids the administratively scoped IPv4 multicast space: 

* [239.0.0.0 : 239,255.255.255] 
*/ 

final static int MADDR_LOWBOUND » 0x0000; // [225.1]. 0.0 

final static int MADDR^UPPERBOUND =- OxFFFF; // [225 . 1] .255 .255 
final static String MADDRJ»REFIX « "225.1"; // 225.0.0.0/16 

Hashtable regis teredMaddrs - null; 
/** 

* Initializes the multicast address server. 
*/ 

public MaddrServer () throws RemoteException K 
registeredMaddrs = new Hashtable (); 

} 

/** 

* Allocates and returns a new multicast address. It will first try to fill- 

* any holes within its address space. In other words, it recycles freed 

* addresses. 
* 

* @return the new multicast address. 



Cji 
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* @exception ^^WdrException if it runs out of^^^ given multicast address 

V 

public synchronized inetAddress nextO 

throws RemoteException, MaddrException { 

// find an empty multicast address space 
int maddr = MADDR_LOWBOUND ; 
InetAddress inet_maddr = null; 

while (registeredMaddrs, contains (new Integer (maddr) ) 
&& ++maddr <= MADDR_UPPERBOUND) ; 

// return newly assigned address 
if (maddr MADDR_UPPERBOUND) { 
try { 

in€t_maddr = InetAddress . getByName (toString (maddr) ) ; 

} 

catch (Exception e) { 

e • print StackTrace ( ) ; 

} 

registeredMaddrs .put (inet_maddr, new Integer (maddr) ) ; 
return inet_maddr; 

} 

else { 

throw new MaddrException ( "Multicast address out of bound."); 

} 



★ 

* Free the address. Return the multicast address back to its pool. 
* 

* @param inet_maddr the address to be freed. 
*/ 

public synchronized void remove (InetAddress inet_maddr) 
throws RemoteException { 
registeredMaddrs. remove (inet_maddr) ; 

} 

/* 

* Construct the full IP address format. 
*/ 

protected String toString(int addr) { 

return MADDR_PREFIX + + ((addr »> 8) & OxFF) + " . " + (addr & OxFF) ; 

} 

* The main method executes the server setup process. 
*/ 

public static void main (String args[]) throws RemoteException { 

// check arguments (rtsp server) 
if (args. length != 0) { 

System. err. println ("usage: \n" + "MaddrServer") ; 

System. exit (-1) ; 

) 

System. setErr (System. out) ; 

// Create and install a security manager 

System. setSecurityManager (new RMISecurityManager () ) ; 

// Setup and start the server on local host 
try {. 

LocateRegistry.createRegistry (MADDRSERV_PORT) ; 
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dc^^^ver » new MaddrServer ( ) ; 
'•/^^+ MADDRSERV_PORT + + 0bj_SlK, 



MaddrServer madc^^^ 

Naming, rebind ("/^^ + MADDRSERV_PORT + + obj_i?BK, maddrServer) ; 

System. out .println ( InetAddress .getLocalHost () 

+ " bound in registry at port " 

+ MADDRSERV_PORT) ; 

} 

catch (Exception e) { 

System. err .println (obj„name + ".main: " + e.getMessage 0 ) ; 
e.printStackTrace () ; 

} 



in 
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/* 

* EXTENSION OF. . . 
* 

* 0 (#) Vector . java 1.60 98/09/30 



* Copyright 1994-1998 by Sun Microsystems, Inc., 

* 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. 

* All rights reserved. 
* 

* This software is the confidential and proprietary information 

* of Sun Microsystems, Inc. ("Confidential Information"). You 

* shall not disclose such Confidential Information and shall use 

* it only in accordance with the terms of the license agreement 

* you entered into with Sun. 
*/ 

package marconi .util; 
/** 

* This class extends java. util .Vector so that it's capable of returning its 

* elements as an array of java. lang. String. 

* @autor -riK. 

* @see java. util. Vector 
*/ 

public class Vector2 extends java. util .Vector { 



Uj/ * * 

yi * Constructs an empty vector so that its internal data array 
ifi * has size <tt>10</tt> and its standard capacity increment is 
™ * zero. 

^public Vector2() { 
W super (10); 

^ * Returns a string array representation of this Vector, containing 
j^' * the String representation of each element. 

^ V 

'^public synchronized String [] toStringArray () { 
O String[] result = new String [elementCount] ; 
□ System. arraycopy(elementData, 0, result, 0, elementCount); 
return result; 

} 

} 
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l^Aetwork 

L^^rver (DIRS) : [Maddr Server inlWtc 



/* marconiNet - Internet Rad^^Betwork 

* Distributed Internet Radi^Wrver (DIRS) : [Maddr Server inlWEace] 

•k 

* $<marconi,util.>MaddrServerInterf . java -vl . 0 (prototype version) r 98/8/19. 

* @jdkl,2, -riK, 
*/ 

package marconi .util; 

import java . rmi . * ; 

import java.net . met Address; 

/ * ★ 

* This interface provides centralized distribution of global multicast addresses, 
*/ 

public interface MaddrServerlnterf extends Remote { 

public InetAddress nextO 

throws RemoteException, MaddrException; 

public void remove ( InetAddress maddr) 
throws RemoteException; 

} 
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/* marconiNet - Internet Racj^^petwork 

* Distributed Radio Antenna^Rver (RAS) : (Base64 Wrapper cMR] 
* 

* $<marconi.util.>Base64. java -vl . 0 (prototype version), 1999/05/13 $ 

* 0jdkl.2, -riK. 
V 

package marconi ,util; 
import java.util •*; 



/** 

* This class is a Base64 wrapper for ASCII representation of BINARY data. 

* It follows the PEM encoding formula. 

* <p> 
★ 

* ^author -riK. 

* Aversion $Revision: 1.0 $ 

* Ssince prototype vl.O 
V 

public class Base64 { 



/ ★ * 

* Maps binary to char. 
*/ 

private static int map{int c) { 
O if (c >= 0 && c <= 25) return (c + 'A'); 

if (c >= 26 && c <= 51) return (c - 26 + 'a'); 
m if (c >^ 52 && c <= 61) return (c - 52 + '0'); 
%1 if (c — 62) return ('+') ; 

if (c == 63) return (' /'); 
0^ else return(-l); 

i> 

J * Maps, char to binary. 
~ */ 

.^"private static int unmapdnt c) { 

if (c >= 'A' && c <= 'Z') return (c - 'A'); 
H= if (c >= 'a' &4 c <= 'z') return (c + 26 - ' a' ) ; 
m if (c >= '0' && c <= '9') return (c + 52 - '0'); 
n if (c '+') return (62); 
5 if (c '/') return (63); 
^ else return (-1); 
} 



/ * * 

* Decodes base64. 
V 

public static byte(] decode (byte [ ] string) { 
int length, i, j; 
byte[] buf - {0}; 

if (string — null) { 
return buf; 

} 

length = string. length; 
buf = new byte [{ (length / 4) * 3) + 1]; 
for (i « j = 0; i < length; i +=» 4, j += 3) { 
while (i < length && string [i] !« 4& 

! (string [i] >- 'a' && string [i] <= ' z' ) && 
!(string[i] >= 'A' && string[i] <= ' Z' ) && 
! (string [i] >= '0' && string [i] <« '9')) i++; 
buf[j] = (byte) ( (unmap (string [i] ) & 0x3f) « 2); 
if (string [i+1] =='=') { 
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bu£[ j+^B 0; 
break; 

} 

buf[j] 1= (byte) ( (unmap (string [i+1] ) & 0x30) » 4) ; 
buf[j+l] = (byte) ( (unmap (string [i+1] ) & OxOf) « 4); 
if (string[i+2] == '=') { 

buf[j+2] = 0; 

break; 

} 

buf[j+l] 1= (byte) ( (unmap (string [i+2] ) & 0x3c) » 2); 
buf[j+2] = (byte) ( (unmap (string [i+21 ) & 0x03) « 6); 
if (string [i+3] =='=') { 

buf[j+3] = 0; 

break; 

} 

buf[j+2] 1= (byte) unmap (string li+3] ) & 0x3f; 

\ 

return buf; 



* Encodes base64, 
V 

public static byte [ ] encode (byte ( 1 bin) { 
_ int BLOCKS_PER_LINE = 18; 

O int length, i, j, cnt; 

p byte[] buf = {0}; 

^ if (bin == null) { 

return buf; 

2 length = bin. length; 

byte[] string = new byte [length +2]; 
System. arraycopy (bin, 0, string, 0, length); 
t cnt = (((length + 3) / 3) * 4) + 2; 

Q cnt += (cnt / (BLOCKS_PER_LINE * 4)); 

m buf = new byte [cnt]; 

" for (i = j cnt = 0; i < length + .3; i += 3, j +=• 4) { 

^ buf[j] = (byte) map ( (string [i] & Oxfc) » 2); 

buf[j+l] = (byte) (map (( (string [i] & 0x03) « 4) | 
a ( (string[i+l] & OxfO) » 4))); 

n if (string[i+l] 0) { 

buf[j+2] = buf[j+3] = (byte) '='; 

j += 4; 

break; 

} 

buf[j+2] = (byte) (map (( (string [i+1] & OxOf) « 2) I 

( (string[i+2] & OxcO) » 6))); 
if (string [i+2] == 0) { 

buf[j+3] - (byte) '='; 

j +- 4; 

break; 

} 

buf[j+3] = (byte) map (string [i+2] & 0x3f ) ; 
if (cnt >= (BLOCKS_PEIL-LINE - 1) ) { 

buf[j+4] « (byte) ' \n' ; 

buf[j+5] = (byte) ' 

j 2; 

cnt = 0; 

} 

else cnt++; 

} 

return buf; 
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# 



* Test function. 
*/ 

public static void main (String args[l) { 
// bytel] in = {(byte)Oxff, (byte)0x33, (byte)0x55}; 

// byte[] out encode (in); 

byted out = encode (args [0] .getBytes ()) ; 

System. out .print In (new String (out) ) ; 

System.out .println(new String (decode (out ) ) ) ; 

} 




■s 
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a^rerver (RAS) : [Session Descript^ro 



/* marconiNet - Internet Ra j 

* Distributed Radio Antenna^^rver (RAS) : [Session DescriptWir (SDP) Class] 
* 

* $<marconi.util-sd.>SDPPacket. java -vl . 0 (prototype version), 1999/03/15 $ 

* ejdJcl,2, -riK. 
V 

package marconi .util . sd; 

import java .util . StringToJcenizer; 
import marconi. util. Vector2; 

/** 

* This class encapsulates and parses the <code>media</code> field of Session 

* Description Protocol. 

* <p> 

* ^author -riK. 

* 0version SRevision: 1.0 $ 

* Ssee marconi. util.sd.SDPPacket 

* Ssince prototype vl.O 
*/ 

public class SDPMedia { 
/** 

* The session name. 

9 V 

^^protected String media - null; 

^/** 

fri * The session information, 
.^public String title = null; 

^ * The media connection information (multiple specification not supported) 

O */ 

public SDPConnection connection = null; 
^ /** 

^ * The bandwidth information. 

y */ 

p public String bandwidth = null; 

* The encryption key. 
*/ 

public String key - null; 

I 'kit 

* The media attributes. 
*/ 

public String attribute [1 » null; 
/**" 

* The media type (audio, video, application, ...etc.). 
V 

private String mediaType « null; 

j -k-k 

* The transport port to which the media stream will be sent. 
V 

private String mediaPort =» null; 
/★* 
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* The transport p^^Pcol. 
*/ 

private String mediaTransport = null; 
/ ★ ★ 

* The media formats. 
*/ 

private String [] mediaFormat = null; 

I -k-k 

* The default constructor with specific format list, 
V 

public SDPMedia (String type. String port. String transport. String [] format) 
mediaType = type; 
mediaPort = port; 
mediaTransport = transport; 
mediaFormat = format; 
media = compose (); 

} 

/ * * 

* The default constructor with default media format. 
*/ 

public SDPMedia (String type. String port, String transport) { 
String [] fmt = {"0"}; 
mediaType = type; 
mediaPort = port; 
mediaTransport = transport; 
mediaFormat = fmt; 
media = compose () ; 

} 

/** 

* The constructor. 
*/ 

public SDPMedia (String media) { 
thiis. media = media; 
Vector2 temp_vec - new Vector2 () ; 

StringTokenizer st = new StringTokenizer (media, " "); 

if (st .hasMoreTokens 0 ) { 

this. mediaType = st .next Token () ; 

} 

if ( St. hasMoreTokens () ) { 

this .mediaPort = st .nextToken ( ) ; 

} 

if (st .hasMoreTokens () ) { 

this .mediaTransport st. nextToken () ; 

} 

whi le ( s t . hasMoreTokens ( ) ) { 

t emp_vec . addElement ( st . nextToken () ) ; 

} 

this. mediaFormat = temp_vec .toStringArray () ; 

} 

/ * ♦ 

* Returns the type of media. This variable is not directly accessible 

* because they are read-only. 
*/ 

public String getTypeO { 
return mediaType; 

} 

/ ★ * 
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* Returns the port numb^^Bor media communication. This ^^Bable is not 

* directly accessible b^^mse they are read-only. 
*/ 

public String getPortO { 
return mediaPort; 

} 

/■k-k 

* Returns the transport protocol used. This variable is not directly 

* accessible because they are read-only. 
*/ 

public String getTransport ( ) { 
return mediaTransport ; 

} 

/ ★ * 

* Returns the media format list. This variable is not directly accessible 

* because they are read-only. 
V 

public String [] getFormatO { 
return mediaFormat; 

} 

/ * * 

Returns concatenated media description. 

OV 

protected String compose () { 
Ln string temp_str = 

.f^ for (int i = 0; i < mediaFormat . length; i++) { 

~ temp_str = temp_str + ( (i~0) ?"":"")+ mediaFormat [ i ] ; 

i; } 



return mediaType + " " + mediaPort + " " + mediaTransport + " " + temp_str; 



} 

m 
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la^Wrver (RAS) : [Session Descript^^r ( 



/* marconiNet - Internet Rac 

* Distributed Radio Antenna'^^ver (RAS) : [Session Descript^^ (SDP) Class] 
* 

* $<marconi,util.sd.>SDPPacket . java -vl , 0 (prototype version), 1999/03/15 $ 

* 0jdkl.2, -riK. 
V 

package marconi .util • sd; 

import java, util 

/** 

* This class encapsulates and parses the <code>connection</code> field of Session 

* Description Protocol, Currently only IP4 address type is defined by the 

* protocol, 

* <p> 
* 

* @author *riK. 

* gversion $Revision: 1.0 $ 

* @see marconi. util.sd.SDPPacket 

* @since prototype vl.O 
*/ 

public class SDPConnection { 
/ * * 

* The type of network. 

o*/ 

:^ublic String network_type = "IN"; 

* The type of address. 

S */ 

yjjublic String address_type = "IP4"; 

" * The base multicast address for connection. 

^ */ 

^public String address = 

N=/** 

ty * The connection ttl (time to live) . 

|-.public String ttl = 
/** 

* The number of contiguous addresses including the base address. 
*/ 

public String count « 
* 

* Default constructor. The subfields take the default values. It is the 

* user's responsibility to make sure that the required subfields are 

* properly initialized. 
*/ 

public SDPConnection 0 { 
super ( ) ; 

} 

/** 

* Constructor. It does not check for the valid number of subfields. This 

* simple parser uses the default values if the input is short of fields. 
V 

public SDPConnection (String connection) { 

StringTokenizer st new StringTokenizer (connection, " "); 
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2 



if 



(St .hasMorei 




sO) { 



this.netwo«5ype = st .nextToken () ; 
} 

if (st.hasMoreTokensO ) { 

this .address^type = st .nextToken () ; 

} 

if (address_type.startsWith(''IP4") ) { 
if (st.hasMoreTokens 0 ) { 

String connect ionAddress = st . nextToken () ; 

StringTokenizer st2 = new StringTokenizer (connectionAddress, 
if {st2 .hasMoreTokens 0 ) { 



this. address ~ st2 .nextToken () ; 

} 

if ( st 2. hasMoreTokens 0 ) { 

this.ttl = st2 .nextToken 0 ; 

} 

if ( st 2. hasMoreTokens 0 ) { 

this. count = st2 .nextToken () ; 



while (st .hasMoreTokens 0 ) { 

this. address = address + " " + st .nextToken () ; 



* Returns the <code>String</code> of concatenated connection subfields. 
V 

protected String compose () { 

return network_type + " " + address_type + " " + address 



+ ( address_type, equals ('•IP4") ? + ttl + "/" + count : "") 



else { 



this. address = address .trim () ; 




1 



/* marconiNet - Internet Rad, 
* Distributed Radio Antenna 



[Session Announcertu 




Protocol Class] 



* $<marconi.util.sd.>SAPPacket. java -vl . 0 (prototype version), 1999/03/15 $ 

* @jdkl.2, -riK. 
*/ 

package marconi.util.sd; 
import marconi*util .Timestamp; 



* This class encapsulates and parses the Session Announcement Protocol (SAP) 

* Packet. Within it, SDP packet in also encapsulated. Many of the security 

* related fields are still being defined and thus not fully supported in this 

* version. It merely supports the parsing of these fields. For example, the 

* encrypted payload is not parsed and left to be handled by the next version, 

* or an object that extends this, or an object that encapsulates this (parent 

* object) . 

* <p> 

* Included in the packet are the following fields: 

* <ul> 

* <li>version 

* <li>message type 

* ^i>encryption bit 

* 5ii>compression bit 

* <^'i>authentication header length 

* 4Bi>message id hash 

* <^i>originating source 

* @i>authentication header 

* ^i>timeout 

* :^i>payload 

* ;^ul> 
* 



put^c class SAPPacket implements java. io . Serializable { 

final static String obj_name = "marconi.util. SAPPacket"; 

/ * ♦ 

* The version ID. 
*/ 

public final static iAt version =» 1; 
/** 

* The message type, 
*/ 

public byte message.type - MT_,ANNOUNCE; 
/** 

* The encryption bit. 
*/ 

public boolean encryption - false; 

* The compression bit. 
*/ 

public boolean compression = false; 



/** 



* 



* ©uthor -riK. 

* gyersion $Revision: 1.0 $ 

* fijsee marconi .util .sd.MalformedSDException 

* 5^ee marconi. util.sd.SDPPacket 

* ^ince prototype vl.O 
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* The authenticat 





public short auth_headerlen = 0; 
/** 

* The message identifier hash. 
V 

public short msgid.hash = 0; 
/ * * 

* The orginating source, 
*/ 

public byte[] source = new byte [4]; 

I -k-k 

* The authentication header. 
*/ 

public int[] auth_header = null; 
/ * * 

* The timeout. 
*/ 

public int timeout = 0; 



* The text payload (if encrypted contains the privacy header field) . 
*/ 

public byte[] payload = null; 
/** 

* The date and time of the packet created. 
V 

public long timeStamp = -1; 
/** 

* The maximum payload buffer length (currently IK bytes as limited by SAP) . 
*/ 

public final static int MAX_BUFLEN = 1024; 
/** 

* The <code>announce</code> message type. 
V 

public final static int MT_ANNOUNCE = 0; 

I -k-k 

* The <code>delete</code> message type. 
V 

public final static int MT_DELETE = 1; 

I kk 

* Raw data containing the byte-array representation of the packet. 
*/ 

private byte[] data = null; 

* Creates an empty SAP packet. 
V 

public SAPPacketO { 

this. timeStamp =» Timestamp.get_current () ; 

} 

/*★ 

* Creates SAP packet from a byte array. 



/ kk 
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* @param buf the array that contains SAP/SDP.^^ 

public SAPPacket (byte[l buf) throws Half ormedSDException { 
parse (buf) ; 

this . timeStamp. = Timestamp.get_current 0 ; 

} 

/ * * 

* Obtains a SAP packet by parsing a byte array. 

* @param buf a byte array that contains SAP/SDP. 
V 

public void parse (byte [] buf) throws Half ormedSDException { 
int bO, bl, b2, b3, i = 0; 

// main sap header 
bO = buf [i] ; 

bl = (buf [i+1] « 24) »> 24; 
b2 = (buf [i+2] « 24) »> 24; 
bS = (buf ti+3] « 24) »> 24; 
int main_header = bO « 24 I bl « 16 1 b2 « 8 I b3; 
i += 4; 

if (version != ( (main_header & OxeOOOOOOO) »> 29)) { 
throw new Malf ormedSDException 
ri (obj_name + ".parse: incompatible version received."); 

~: this.message_type = (byte) ( (main_header & OxlcOOOOOO) »> 26); 

this. encrypt ion = (main_header & 0x02000000) > 0; 
^ this. compression = (main_header & 0x01000000) > 0; 

V\ this.auth_headerlen = (short) ( (main_header & OxOOffOOOO) >» 16); 
m this .msgid_hash = (short) (main_header & OxOOOOf f f f ) ; 

m 

// originating source 
^ this • source [0] =»buftil; 

this. source [1] =buf[i+l]; 
O this. source [2] =buf[i+2]; 
y= this.source[3] =buf[i+3]; 
1=^ i 4; 

S // authentication header 

^* this .auth_header = new int [auth_headerlen] ; 
^ for (int j = 0; j < auth_headerlen; i ++j*4) ( 
bO = buf[i]; 

bl » (buf [i+1] « 24) »> 24; 
b2 » (buf[i+2] « 24) »> 24; 
b3 = (buf [i+3] « 24) »> 24; 

this.authjieader [ j] - bO « 24 I bl « 16 I b2 « 8 I b3; 

} 

// 32-bit timeout field 
if (encryption) { 
bO = buf[il; 

bl » (buf[i+l] « 24) »> 24; 
b2 = (buf [i+21 « 24) »> 24; 
b3 = (buf[i+3] « 24) »> 24; 

this. timeout = bO « 24 | bl « 16 I b2 « 8 I b3; 
i += 4; 

} 

// payload 

int payloadlen = Math.min (MAX_BUFLEN, buf. length - i) ; 
this. payload = new byte [payloadlen] ; 

System. arraycopy (buf , i, this .payload, 0, payloadlen); 
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} 

I -k-k 

* Returns the buffer that represents this SAP packet. 

* ^return byte array representation of this SAP packet (including payload) . 
V 

public byte[] compose {) { 

int bO, blr b2, b3, i, j; 

// integrity check 
if (payload null) { 
return null; 

} 

if (auth_header != null) { 

// just in case they don't match 
auth_headerlen = (short) auth_header . length; 

} 

int length = 4 + 4 + auth_headerlen * 4 + 

((encryption) ? 4 : 0) + payload. length; 
data = new byte [length] ; 

// main header 
_^ bO = version; 

P bl = message_type; 

jfl b2 = (encryption) ? 1 : 0; 

\n b3 = (compression) ? 1 : 0; 

data[0] = (byte) (bO « 5 I bl « 2 | b2 « 1 | b3) ; 
^ data[l] = (byte) (auth_headerlen) ; 

data[2] = (byte) (msgid„hash » 8); 
iy data [3] = (byte) (msgid_hash) ; 

01 data [4] = source [0] 

^ data [5] = source [1] 

data [6] = source [2] 

data [7] = source [3] 

f^' // authentication header 

H= for (j = 0, i = 8; j < auth_headerlen; i += ++j*4) 

m data(i] = (byte) (auth_header ( j] » 24); 

n data[i+l] = (byte) (auth_header [ j ] » 16); 

P data[i+2] = (byte) (auth_header [ j] » 8); 

data[i+3] = (byte) (auth_header [ j] ) ; 



// timeout field 
if (encryption) ( 

data[i] = (byte) (timeout » 24); 

data[i+l] ^ (byte) (timeout » 16); 

data[i+2] - (byte) (timeout » 8); 

data(i+3] - (byte) (timeout); 

i += 4; 



// payload 

System. arraycopy (payload, 0, data, i, payload. length) ; 
return data; 

} 
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/* marconiNet - Internet Rac^^^etwork 

* Distributed Radio Antenna^Rver (RAS) : [Session Descript^^ (SDP) Class] 

* $<marconi.util.sd.>SDPOrigin. java -vl . 0 (prototype version), 1999/04/06 $ 

* @jdkl.2, *riK. 
*/ 

package marconi.util.sd; 

import java.util.StringTokenizer; 

f -kit 

* This class encapsulates and parses the <code>origin</code> field of Session 

* Description Protocol • 

* <p> 

* @author ^-riK. 

* Qversion $Revision: 1.0 $ 

* @see marconi.util.sd.SDPPacket 

* Qsince prototype vl . 0 
*/ 

public class SDPOrigin { 
/ * * 

* The username. 
public String username = 

in 

^ * The session id. 

2'/ 

'public String session_id = "0"; 

'm 
&f - 

s * The announcement version. 

a */ 

j^public String version = "0"; 
V * The type of network. 

O */ 

Q public String network_type = "IN"; 
/** 

* The type of address. 
V 

public String address_type - "IP4"; 
/** 

* The originating network address. 
*/ 

public String address - ""; 
/ ** 

* Default constructor. The subfields take the default values. It is the 

* user's responsibility to make sure that the required subfields are 

* properly initialized. 
V 

public SDPOrigin 0 { 
super ( ) ; 

} 

* Constructor. It does not check for the valid number of subfields. This 

* simple parser uses the default values if the input is short of fields. 
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public SDPOrigin (StSKTg origin) { 

StringTokenizer st = new StringTokenizer (origin, " "); 

if (St .hasMoreTokens 0 ) { 

this.username = st .nextToken ( ) ; 

} 

if (st .hasMoreTokens 0 ) { 

this.session_id = st .nextToken () ; 

} 

if (st .hasMoreTokens 0 ) { 

this. version = st .nextToken () ; 

} 

if (st .hasMoreTokens 0 ) { 

this .network_type = st . nextToken () ; 

} 

if (st .hasMoreTokens 0 ) { 

this .address_type = st . nextToken () ; 

} 

if (st .hasMoreTokens 0 ) { 

this. address = st .nextToken () ; 

} 

} 

/ * * 

* Returns the <code>String</code> of concatenated origin subfields. 
*/ 

protected String compose () { 

return username + " " + session_id + " " + version + " " 

+ network_type + " " + address_type + " " + address; 

} 
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ac^^»etwor)c 

i^flerver (RAS) [Session DescriptM^ 



/* marconiNet - Internet Racj^^ 

* Distributed Radio Antenna^^rver (RAS) : [Session DescriptWF (SDP) Class] 
* 

* $<marconi.util.sd.>SDPPacket, java -vl . 0 (prototype version), 1999/03/15 $ 

* ejdkl.2, --riK. 
*/ 

package marconi .util . sd; 

import java.util-*; 

import java.io.*; 

import marconi .util. Timestamp; 

import marconi. util. Vector2; 

/** 

* This class encapsulates and parses the Session Description Protocol (SDP) 

* Packet. It does not support parsing of the full SDP fields but only enough 

* to support CDP (Channel Description Protocol) . Thus, it does not parse into 

* the subfields of SDP if they are not to be used for channel description, 

* Further, the parser tolerates other passive errors such as the existence of 

* fields that are not defined. However, the composing and parsing of SDP is 

* 100% compliant with the standard specification. In order to facilitate this 

* the parser strictly checks for the order and the existence of the required 

* fields. 

* 5P> 

* ©le syntax of the SDP fields are given below: 

* ^1> 

* js<a.i>v=0 

* J^i>o=<usernarae> <session id> ilt; versionigt; <network typeigt; 

* ^t; address type> < address> 

* .^ii>s==ilt; session name> 

* Wli>i="< session description> 

* pli>u»<uri> 
*vlli>e-< email address> 
*^<li>p=& It; phone number> 

*i^li>c=< network type> <address type> < connection address> 
*yii>b=<modifier> : <bandwidth-value> 
*!Q^li>t=&lt ; start time> <stop tirae> 

*Hli>r=4lt; repeat interval> ilt; active durationigt; <list of offsets> 
*\Sli>z=< adjustment time> 4lt; of f set> ... 
*g;li>k«& It ; method&gt ; 

*g:li>k=<method> : < encryption key> 
*""<li>a=<attribute> 

* <li>a«<attribute> :< value> 

* <li>m=<media> <port> < transport&gt ; <fmt list> 

* </ul> 

* <p> 
* 

* Qauthor -riK. 

* Aversion $Revision: 1.0 $ 

* @see marconi. util. sd.MalformedSDException 

* Gsee marconi. util.sd.SDPOrigin 

* Gsee marconi. ut 11. sd.SDPMedia 

* Gsee marconi .util. sd.SDPConnection 

* Gsee marconi.util.sd.SAPPacket 

* Gsince prototype vl.O 
V 

public class SDPPacket implements java.io.Serializable { 

final static String obj.name - "marconi. util. SDPPacket"; 



* The protocol version. 
*/ 

public final static int version = 0; 



u 
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* The owner/creato^and session identifier. 
*/ 

public SDPOrigin origin = new SDPOriginO; 

/ it-k 

* The session name. 
*/ 

public String name = 
/ * * 

* The session information, 
*/ 

public String info = null; 
/ * * 

* The URI of description. 
*/ 

public String uri = null; 
/ * ★ 

* The contact email address, 
*/ 

public String [] email = null; 
/ ** 

* The contact phone number. 
*/ 

public String [] phone = null; 
/ * * 

* The session level connection information. 
*/ 

public SDPConnection connection = new SDPConnection () ; 

/it* 

* The bandwidth information. 
V 

public String bandwidth = null; 
/** 

* The time zone adjustments. 
*/ 

public String zone = null; 
/** 

* The encryption key. 
V 

public String key = null; 
/ * * 

* The session attributes. 

V 

public String [] attribute = null; 
/** 

* The active times (NTP in seconds = Oh on January 1900). 
*/ 

public String [] active = {"0 0"}; 
/* * 

* The repeat times. 
*/ 

public String [] repeat = null; 
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• # 

* The media description. 
*/ 

public SDPMedia[] media = new SDPMedia [MAX_>IEDIACOUNT] ; 
/** 

* The date and time; of the packet created. 
V 

public long timeStamp = -1; 
/ * * 

* The number of media descriptions. 
V 

public int mn = 0; 
/** 

* The maximum number of media descriptions. 
*/ 

public final static int MAX_MEDIACOUNT = 10; 
/** 

* Raw data containing the byte-array representation of the packet, if it has 
one . 

ygrivate byte[] data = null; 

Creates an empty SDP packet, 
i^ublic SDPPacketO { 

ffl this.timeStamp = Timestarap.get_current () ; 

~* Creates SDP packet from a (received) SAP payload. 

H* Gparam buf a byte array that contains SDP. 

\0 */ 

gpublic SDPPacket (byte [] buf) throws MalformedSDException { 
g parse (buf); 

~" this.timeStamp = Timestamp.get_current {) ; 
} 

/** 

* Creates a SDP packet from a file. 
* 

* @param file pathname to where the SDP-file is located. 
*/ 

public SDPPacket (String file) throws MalformedSDException { 
parse (file) ; 

this.timeStamp - Timestamp.get_current () ; 

} 

/ * * 

* Obtains a SDP packet by parsing the SAP payload. 
* 

* Qparam buf a byte array that contains SAP payload (SDP content) . 
*/ 

public void parse (byte [] buf) throws MalformedSDException { 
/* 

* Open packet buffer as stream. 
*/ 
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Buf fereciReacier^B|_in = new Buf feredReader (new l^^^StreamReader 

(new ByteA^^yrnputStreani(buf ) ) ) ; 

try { 

parse (buf_in) ; 
buf_in, close () ; 

} 

catch (MalformedSDException e) { 
throw new MalformedSDException 

(obj_name + ".parse: packet cannot be parsed."); 

} 

catch (lOException e) { 
} 

} 

I -k-k 

* Obtains a SDP packet from a file. 
* 

* Sparam file_path name and path of the SDP announcement file. 
V 

public void parse (String file_path) throws MalformedSDException { 
/* 

* Open file. 
*/ 

File file = new File (f ile_path) ; 
Buf feredReader file_in = null; 
try { 

file_in = new Buf feredReader (new FileReader (f ile) ) ; 
parse (f ile_in) ; 
file_in. close () ; 

} 

catch (FileNotFoundException e) { 
e . print StackTrace ( ) ; 

} 

catch (MalformedSDException e) { 
throw new MalformedSDException 

(obj_name + ".parse: file cannot be parsed."); 

} 

catch (lOException e) { 
} 

/ * * 

* Parse ordered fields. 
V 

protected void parse (Buf feredReader parser) throws MalformedSDException { 
boolean perror =» false; 

parse_err : 

try { 

V€Ctor2 temp_vec = new Vector2(); 
String line = parser. readLine () ; 

// V 

if (line null && line.startsWith("v=") ) { 

String v_str = line . substring (line . indexOf ('=' ) + l).trim(); 

System. out. print In (obj_name + ".parse: " + line); 

if (Integer. parseint (v_str) > this. version) { 
throw new MalformedSDException 

(obj_name + ".parse: incompatible version received."); 
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i^^^eadLine 0 ; 



} 

line ~ parsel^eadLine 0 ; 

} 

else { 

perror - true; 
break parse_err; 

} 

// o 

if (line !- null && line • start sWith ("o=") ) { 
System. out .println (obj_name + ".parse: " + line) ; 

this. origin - new SDPOrigin (line . substring 

(line.indexOf ('=' ) + l).trim()); 
line = parser .readLine 0 ; 

} 

else { 

perror ~ true; 
break parse_err; 

} 

// s 

if (line != null line . startsWith ( "s=" ) ) { 

System, out- print In (obj_nanie + ".parse: " + line); 

O this. name = line . substring (line . indexOf ('=' ) + l).trim(); 

''<D line - parser .readLine 0 ; 

^ else { 

ffi perror true; 

'"f^^ break parse_err; 

} 

// i 

if (line != null && line.startsWith("i=") ) { 



Q System. out .println (obj_name + ".parse: " + line); 

this. info = line. substring (line . indexOf ('»' ) + l).trim(); 
line =» parser .readLine 0 ; 

^ } 

G // u 

Q if (line != null && line .startsWith ("u=") ) { 

System. out .println (obj_name + ".parse: " + line); 

this.uri « line .substring (line . indexOf ('=' ) + l).trim(); 
line » parser • readLine 0 ; 

} 

// e 

if (terap_vec.size() > 0) { 

ten^^vec.removeAllElements () ; 

} 

while (line !- null && line. start sWith ("e=") ) { 

System. out .println (obj_narae + ".parse: " + line); 

temp.vec.addElement (line. substring (line. indexOf('=') + 1) .trimO); 
line - parser . readLine 0 ; 

} 

if (temp_vec.3ize() > 0) { 

this. email = temp_vec.toStringArray 0 ; 

} 

// P 

if (temp_vec.size() > 0) { 
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temp^vd^^ftmoveAllElements 0 ; 

while (line != null line . startsWith ( "p=" ) ) { 

System.out .println{obj_naine + ".parse: " + line); 

temp.vec.addElement (line . substring (line . indexOf (' =' ) + D .trimO ) ; 
line = parser .readLine 0 ; 

} 

if (temp_vec.size 0 > 0) { 

this. phone = temp_vec . toStringArray ( ) ; 

} 

// c 

if (line != null && line . startsWith ( "c=" ) ) ( 
System. out .print In (obj_name + ".parse: " + line) ; 

this .connection = new SDPConnection (line . substring 

(line.indexOf ('=' ) + 1) . trim () ) ; 
line = parser . readLine () ; 

} 

// b 

if (line != null && line. startsWith ("b=") ) { 
O System. out .println (obj_name + ".parse: " + line) ; 



01 



this. bandwidth = line . substring (line . indexOf ('=' ) + l),trim(); 
line = parser .readLine 0 ; 

} 

// z 

^ if (line != null && line. startsWith ("z=") ) { 

=f - 

«C System. out .println(obj_name + ".parse: " + line) ; 

r% this, zone = line , substring (line . indexOf ('=' ) + l).trim(); 

S line = parser. readLine 0 ; 

^: ■ \ 

^ // k 

if (line != null && line.startsWith("k=") ) { 
O this. key = line . substring (line . indexOf ('=' ) + l).trim(); 

ri line - parser. readLine 0 ; 

} 

// a 

if (temp__vec.size 0 > 0) { 

temp_vec . removeAllElement s ( ) ; 

} 

while (line null && line. startsWith ("a=") ) { 

System. out. print In (obj_name + ".parse: " + line); 

terap_vec.addElement (line, substring (line. indexOf (' =' ) + D .trimO ) 
line » parser.readLineO ; 

} 

if (temp_vec.size 0 > 0) ( 

this. attribute = temp_vec. toStringArray () ; 

} 

// t 

if (temp_vec.size 0 > 0) { 

temp_vec . removeAllElements ( ) ; 

} 

while (line != null && line .startsWith ("t=") ) { 
Systera.out .println(obj_name + ".parse: " + line); 



SDPPackat o*va Thu Jim 17 14:33:15 1999 7 * 

temp^vecadd^^ent (line. substring (line, indexG^™-' ) + 1) .trimO); 
line = parse^readLine < ) ; 

} 

if (temp_vec.size 0 > 0) { 

this. active = temp_vec, toStringArray () ; 

} 

else { 

perror true; 
break parse_err; 

} 

// r 

if (temp_vec.size 0 > 0) { 

temp_vec . removeAllElements ( ) ; 

while (line != null && line.startsWith ("r=") ) { 

temp_vec.addElement (line.substringdine.indexOf ('=' ) + 1) .trimO) ; 
line = parser .readLine () ; 

} 

if (temp_vec.size 0 > 0) { 

this. repeat = temp_vec.toStringArray () ; 

} 

// m 

while (line != null && line. start sWith ("m=" ) ) { 



S System, out .println(obj_name + ".parse: " + line); 

in 



if (mn < MAX_MEDIACOUNT) { 
mn++; 

this. media [mn-1] - new SDPMedia (line. substring 

(line.indexOf ('=' ) + D.trimO); 
line = parser.readLine 0 ; 
// i 

if (line null && line.startsWithCi-") ) { 
media [mn-1] .title = line. substring 
(line.indexOf ('-' ) + 1) .trim{) ; 
line = parser .readLine () ; 

} 

// c 

if (line != null && line .startsWith (*c=") ) { 
media [mn-1] .connection » new SDPConnection 

(line.substringdine.indexOf ('=' ) + D.trimO); 
line = parser . readLine 0 ; 

} 

// b 

if (line !» null && line. start sWith ("b=-") ) { 
media [mn-1] .bandwidth = line. substring 

(line.indexOf ('=' ) + D.trimO; 
line - parser . readLine O ; 

} 

// Ic 

if (line !» null && line.startsWith ("k=") ) { 
media [ran-1] .key = line. substring 

(line.indexOf {'-' ) + D.trimO; 
line - parser.readLine 0 ; 

} 

// a 

if (temp_vec.size O > 0) { 

temp_vec. removeAllElements () ; 

while (line != null && line. start sWith ("a-") ) { 
terap_vec . addElement (line . substring 

(line.indexOf ('-' ) + D.trimO); 
line = parser .readLine 0 ; 

} 
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f^^Blnp.vec.size 0 > 0) { 

ni^Hi a fmn-ll .attribute = temp vec^Bst 
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media [mn-1] .attribute = temp_vec:TUStringArray () ; 
} 

} 

} 

if (mn == 0) { 

perror = true; 
break parse_err; 

} 

} 

catch (lOException e) { 

throw new Malf ormedSDException 

(obj_name + ".parse: session description cannot be parsed."); 

} 

/* 

* Unconunent below if strict formating is desired. 
*/ 

if (perror) { 

throw new Malf ormedSDException 

(obj_name + ".parse: session description cannot be parsed."); 

} 

} 

/ -k-k 

* Composes a byte array that represents this SDP packet. 

* All appropriate fields, not defined as <code>null</code>, are used 

* to make up this packet. The syntax integrity check is not performed 

* during this process. The <code>Malf ormedSDException</code> will be 

* thrown by the parser when the receiver of this packet tries to parse 

* it. 
* 

* greturn a byte array consisting of the valid SDP fields in order. 
*/ 

public byted compose () { 

ByteArrayOutputStream ba = new ByteArrayOutputStreamO ; 

PrintWriter ba^out = new PrintWriter (new OutputStreamWriter (ba) , true); 

ba_out .println ("v«" + version); 
if (origin != null) { 

ba_out. print In ("o=" + origin. compose ()) ; 

} 

if (name != null) { 

ba_out. print In ("s=" + name); 

} 

if (info != null) { 

ba_out .print In ("i-" + info); 

} 

if (uri != null) { 

ba_out .println ("u=" + uri); 

} 

if (email != null) { 

for (int i = 0; i < email. length; i++) 
if (email [i] !- null) 

ba_out .println ("e=" + email[i]); 

} 

if (phone != null) { 

for (int 1=0; i < phone. length; i++) 
if (phone [i] != null) 

ba„out .println ("p=»" + phone[i]); 

} 

if (connection != null) { 

ba_out .println ("c=" + connection. compose ()) ; 

} 
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+ bandwidth) ; ^PF ^ 



if (bandwidth nu3 
ba_out .println (' 
} 

if (zone != null) { 

ba_out .println ("2=" + zone); 

} 

if (key 1= null) { 

ba_out .println ("k='' + key) ; 

} 

if (attribute !=• null) { 

for (int i = 0; i < attribute . length; i++) 
if (attributed] != null) 

ba_out .println("a'=" + attribute [i] ) ; 

} 

if (active != null) { 

for (int i = 0; i < active . length; i++) 
if (active [i] != null) 

ba_out .println ("t=" + active [i]); 

} 

if (repeat null) { 

for (int i = 0; i < repeat . length; i++) 
if (repeat [i] != null) 

ba_out .println ("r=" + repeat [i]); 

p. ^ 

□ for (int i = 0; i < media. length; i++) { 

^ if (media [i] != null) { 

yi if (media [i] .media != null) { 

,r| ba_out .println ("m=" + media [i] .media) ; 

^ if (media [i] .title != null) { 

^ ba_out .println ("i=" + media [i] .title) ; 

HI ^ 

4= if (media [i] .connection !=" null) { 

ba_out .println ("c=" + media [i] .connect ion. compose ()) ; 

n } 

^ if (media [i] .bandwidth !- null) { 

ba_out .println ("b=" + media [i] .bandwidth) ; 

^ } 

^ if (media[i] .key null) { 

O ba_out .println ("k-" + media [i] . key) ; 

O > 

if (media [i] .attribute !« null) { 

for (int j = 0; j < media [i] .attribute. length; j++) 

if (media [i] .attribute! j] null) 

ba_out. println ("a=" + media [i] . attribute [ j] ) ; 

} 

} 

} 

data = ba.toByteArray 0 ; 
ba_out. close 0 ; 

return data; 



